std.datetime

Phobos provides the following functionality for time:


Functionality	Symbols
Points in Time	Clock Date TimeOfDay DateTime SysTime
Timezones	TimeZone UTC LocalTime PosixTimeZone WindowsTimeZone SimpleTimeZone
Intervals and Ranges of Time	Interval PosInfInterval NegInfInterval
Durations of Time	Duration weeks days hours minutes seconds msecs usecs hnsecs nsecs
Time Measurement and Benchmarking	MonoTime StopWatch benchmark

This functionality is separated into the following modules:

std.datetime.date for points in time without timezones.
std.datetime.timezone for classes which represent timezones.
std.datetime.systime for a point in time with a timezone.
std.datetime.interval for types which represent series of points in time.
std.datetime.stopwatch for measuring time.

Modules

date module std.datetime.date


Category	Functions
Main date types	Date DateTime
Other date types	Month DayOfWeek TimeOfDay
Date checking	valid validTimeUnits yearIsLeapYear isTimePoint enforceValid
Date conversion	daysToDayOfWeek monthsToMonth
Time units	cmpTimeUnits timeStrings
Other	AllowDayOverflow DateTimeException

interval module std.datetime.interval


Category	Functions
Main types	Interval Direction
Special intervals	everyDayOfWeek everyMonth everyDuration
Special intervals	NegInfInterval PosInfInterval
Underlying ranges	IntervalRange NegInfIntervalRange PosInfIntervalRange
Flags	PopFirst

stopwatch module std.datetime.stopwatch

Module containing some basic benchmarking and timing functionality.

systime module std.datetime.systime


Category	Functions
Types	Clock SysTime DosFileTime
Conversion	parseRFC822DateTime DosFileTimeToSysTime FILETIMEToStdTime FILETIMEToSysTime stdTimeToFILETIME stdTimeToUnixTime SYSTEMTIMEToSysTime SysTimeToDosFileTime SysTimeToFILETIME SysTimeToSYSTEMTIME unixTimeToStdTime

timezone module std.datetime.timezone


Category	Functions
Time zones	TimeZone UTC LocalTime PosixTimeZone WindowsTimeZone SimpleTimeZone
Utilities	clearTZEnvVar parseTZConversions setTZEnvVar TZConversions

Public Imports

core.time public import core.time;: Undocumented in source.

std.datetime.date public import std.datetime.date;: Undocumented in source.

std.datetime.interval public import std.datetime.interval;: Undocumented in source.

std.datetime.systime public import std.datetime.systime;: Undocumented in source.

std.datetime.timezone public import std.datetime.timezone;: Undocumented in source.

Examples

Get the current time from the system clock.

import std.datetime.systime : SysTime, Clock;

SysTime currentTime = Clock.currTime();

Construct a specific point in time without timezone information and get its ISO string.

import std.datetime.date : DateTime;

auto dt = DateTime(2018, 1, 1, 12, 30, 10);
assert(dt.toISOString() == "20180101T123010");
assert(dt.toISOExtString() == "2018-01-01T12:30:10");

Construct a specific point in time in the UTC timezone and add two days.

import std.datetime.systime : SysTime;
import std.datetime.timezone : UTC;
import core.time : days;

auto st = SysTime(DateTime(2018, 1, 1, 12, 30, 10), UTC());
assert(st.toISOExtString() == "2018-01-01T12:30:10Z");
st += 2.days;
assert(st.toISOExtString() == "2018-01-03T12:30:10Z");

std.datetime

Modules

Public Imports

Examples

See Also

Meta

Source

License

Authors