Method Val.TimeTZ()->create()

Method create

Val.TimeTZ Val.TimeTZ(mapping(string:int) tm)

Parameter tm

Standard tm mapping, optionally extended with nsec for nanoseconds. Any specified timezone is used as is. Passed values will not be normalised. Days/months/years are ignored.

Method create

Val.TimeTZ Val.TimeTZ(int year, int month, int day, int hour, int min, void|int sec, void|int nsec)


Stores just the time of the day components, but including the correct timezone offset with any daylight-saving correction active on the date specified.

Parameter year

Absolute year (e.g. 1900 == 1900, 2000 = 2000, 2017 == 2017).

Parameter month

Month of the year (January == 1 ... December == 12).

Parameter day

Day of the month (typically between 1 and 31).

Parameter hour

Hour of the day (typically between 0 and 23).

Parameter min

Minutes (typically between 0 and 59).

Parameter sec

Seconds (typically between 0 and 59).

Parameter nsec

Nanoseconds (typically between 0 and 999999999).


Specified values are expected in the localised time (i.e. relative to the current timezone locale, including daylight-saving correction).


If any of these values are offered in a denormalised range, they will be normalised relative to the startdate offered.

See also

Timestamp, Date, Interval, Time