DateTime

We can use time package to create a DateTime object. Time for create a time object.

Usage

let t = time.parse("2023-04-13 09:45:26")
// t is a DateTime object

t.year
// 2023
t.month
// 4
t.day
// 13

let t1 = time.parse("invalid time")
// t1 is nil

Class Methods

new

Create a new DateTime object.

let t = time.new(2023, 1, 11, 0, 0, 0);
// t is a DateTime object

export let t_str = t.to_string();
// t_str is "2023-01-11T00:00:00Z"

parse (time)

Parse a string to a DateTime object, default time format is RFC3339.

If the time format is invalid, it will return nil.

If there not timezone, use UTC as default.

let t = time.parse("2023-04-13T14:08:33-11:00");

Or it compibility to supports %Y-%m-%d %H:%M:%S format.

let t = time.parse("2023-04-13 09:45:26");

parse (time, format)

You can use parse to pass 2 arguments, the first is the time string, the second is the time format.

time.parse("2023-04-13 09:45:26", "%Y-%m-%d %H:%M:%S");

time.parse("2023-04-13 09:45:26", "%Y-%m-%d %H:%M:%S %z");

time.parse("04/13/2023 09:45:26", "%m/%d/%Y %H:%M:%S");

More details of the time format, see Time Format.

Instance Methods

year

Return the year of the time.

let t = time.parse("2023-04-13 09:45:26")
t.year
// 2023

month

Return the month of the time.

let t = time.parse("2023-04-13 09:45:26");
t.month;
// 4

day

Return the day of the time.

let t = time.parse("2023-04-13 09:45:26");
t.day;
// 13

hour

Return the hour of the time.

let t = time.parse("2023-04-13 09:45:26");
t.hour;
// 9

minute

Return the minute of the time.

let t = time.parse("2023-04-13 09:45:26");
t.minute;
// 45

second

Return the second of the time.

let t = time.parse("2023-04-13 09:45:26");
t.second;
// 26

timestamp

Return the Unix Timestamp (in second) of the time.

let t = time.parse("2023-04-13 09:45:26 +08:00");
t.timestamp;
// 1681350326

format

Return the time string with the Time Format format.

let t = time.parse("2023-04-13 09:45:26 +08:00");

t.format("%Y-%m-%d %H:%M:%S %z");
// 2023-04-13 09:45:26 +0800

t.format("%m/%d/%Y %H:%M");
// 04/13/2023 09:45

iso8601

alias: to_string

Return the time string with the RFC3339 format.

let t = time.parse("2023-04-13 09:45:26 +08:00");
t.iso8601;
// 2023-04-13T09:45:26+08:00

to_string

alias: iso8601

Return the time string with the RFC3339 format.

Time Format

Code	Example	Description
%a	Sun	Weekday as locale’s abbreviated name.
%A	Sunday	Weekday as locale’s full name.
%w	0	Weekday as a decimal number, where 0 is Sunday and 6 is Saturday.
%d	08	Day of the month as a zero-padded decimal number.
%b	Sep	Month as locale’s abbreviated name.
%B	September	Month as locale’s full name.
%m	09	Month as a zero-padded decimal number.
%y	13	Year without century as a zero-padded decimal number.
%Y	2013	Year with century as a decimal number.
%H	07	Hour (24-hour clock) as a zero-padded decimal number.
%I	07	Hour (12-hour clock) as a zero-padded decimal number.
%p	AM	Locale’s equivalent of either AM or PM.
%M	06	Minute as a zero-padded decimal number.
%S	05	Second as a zero-padded decimal number.
%f	000000	Microsecond as a decimal number, zero-padded on the left.
%z	+0000	UTC offset in the form ±HHMM[SS[.ffffff]] (empty string if the object is naive).
%Z	UTC	Time zone name (empty string if the object is naive).
%j	251	Day of the year as a zero-padded decimal number.
%U	36	Week number of the year (Sunday as the first day of the week) as a zero padded decimal number. All days in a new year preceding the first Sunday are considered to be in week 0.
%W	35	Week number of the year (Monday as the first day of the week) as a decimal number. All days in a new year preceding the first Monday are considered to be in week 0.
%c	Sun Sep 8 07:06:05 2013	Locale’s appropriate date and time representation.
%x	09/08/13	Locale’s appropriate date representation.
%X	07:06:05	Locale’s appropriate time representation.
%%	%	A literal % character.