Function std.datetime.systime.SysTime.toISOExtString
Converts this SysTime
to a string with the format
YYYY-MM-DDTHH:MM:SS.FFFFFFFTZ (where F is fractional seconds and TZ
is the time zone).
string toISOExtString() nothrow scope @safe const;
void toISOExtString(W)
(
ref W writer
) const scope
if (isOutputRange!(W, char));
Note that the number of digits in the fractional seconds varies with the number of fractional seconds. It's a maximum of 7 (which would be hnsecs), but only has as many as are necessary to hold the correct value (so no trailing zeroes), and if there are no fractional seconds, then there is no decimal point.
If this SysTime
's time zone is
LocalTime
, then TZ is empty. If its time
zone is UTC
, then it is "Z". Otherwise, it is the offset from UTC
(e.g. +01:00 or -07:00). Note that the offset from UTC is not
enough to uniquely identify the time zone.
Time zone offsets will be in the form +HH:MM or -HH:MM.
Parameters
Name | Description |
---|---|
writer | A char accepting
output range |
Returns
A string
when not using an output range; void
otherwise.
Example
import core .time : msecs, hnsecs;
import std .datetime .date : DateTime;
assert(SysTime(DateTime(2010, 7, 4, 7, 6, 12)) .toISOExtString() ==
"2010-07-04T07:06:12");
assert(SysTime(DateTime(1998, 12, 25, 2, 15, 0), msecs(24)) .toISOExtString() ==
"1998-12-25T02:15:00.024");
assert(SysTime(DateTime(0, 1, 5, 23, 9, 59)) .toISOExtString() ==
"0000-01-05T23:09:59");
assert(SysTime(DateTime(-4, 1, 5, 0, 0, 2), hnsecs(520_920)) .toISOExtString() ==
"-0004-01-05T00:00:02.052092");