summaryrefslogtreecommitdiff
path: root/Help/command/string.rst
diff options
context:
space:
mode:
authorPeter Würth <wuerth.peter@freenet.de>2022-01-27 15:20:15 +0100
committerBrad King <brad.king@kitware.com>2022-01-28 06:23:57 -0500
commitc050d6a01e14500903619589e69a973f1215d109 (patch)
treed78eb4dec319610788d4518d2fe3225e889b9b7c /Help/command/string.rst
parent44939f01e761568ab9fe511d2ddf81a48c7c54b9 (diff)
downloadcmake-c050d6a01e14500903619589e69a973f1215d109.tar.gz
string(TIMESTAMP): add %f specifier for microseconds
The %f specified extends the string(TIMESTAMP) and file(TIMESTAMP) commands to output the timestamp with a microsecond resolution. This convention is offered by python's datetime module. Before, the precision was limited to seconds. The implementation is done by extending existing cmTimestamp methods with a `microseconds` parameter. This parameter is optional in order to be backwards compatible. The timestamps are now received in a cross-platform manner using libuv, since the standard C functions like time() don't allow for sub-second precision. This requires libuv 1.28 or higher. We already require higher than that on Windows, so update the required version for other platforms. Implements: #19335
Diffstat (limited to 'Help/command/string.rst')
-rw-r--r--Help/command/string.rst3
1 files changed, 3 insertions, 0 deletions
diff --git a/Help/command/string.rst b/Help/command/string.rst
index 29ad082a90..9b707eb83d 100644
--- a/Help/command/string.rst
+++ b/Help/command/string.rst
@@ -490,6 +490,9 @@ specifiers:
``%S``
The second of the current minute. 60 represents a leap second. (00-60)
+``%f``
+ The microsecond of the current second (000000-999999).
+
``%U``
The week number of the current year (00-53).