Date/time module¶

Note

To use the methods listed below in your program, you have to put a special import statement at the begining of your LSP file: use datetime;

Functions¶

datetime.now()¶: Returns a new datetime that is set to the current date and time on this computer expressed as local time.

datetime.utcNow()¶: Returns a new datetime that is set to the current date and time on this computer, expressed as the Coordinated Universal Time (UTC).

datetime.today()¶: Returns a new datetime that is set to today’s date, with the time component set to 00:00:00.0.

datetime.isLeapYear(year)¶: Returns true if the year, given as an integer, is a leap year.

datetime.date(year, month, day)¶: Returns a new datetime that is set to the given year, month (1-12) and day (1-31). The time component of the datetime object will be set to 00:00:00.0.

datetime.date(year, month, day, hour, minute, second): Returns a new datetime that is set to the given year, month (1-12), day (1-31), hour (0-23), minute (0-59) and second (0-59).

datetime.span(nbHours, nbMinutes, nbSeconds)¶

datetime.span(nbDays, nbHours, nbMinutes, nbSeconds)

datetime.span(nbDays, nbHours, nbMinutes, nbSeconds, nbMilliseconds)

Datetime¶

type datetime¶

date¶

year¶

month¶

day¶

dayOfWeek¶

dayOfYear¶

hour¶

minute¶

second¶

millisecond¶

add(timespan)¶

addYears(nbYears)¶

addMonths(nbMonths)¶

addDays(nbDays)¶

addHours(nbHours)¶

addMinutes(nbMinutes)¶

addSeconds(nbSeconds)¶

addMilliseconds(nbMillis)¶

format(fmt)¶

Timespan¶

type timespan¶

days¶

hours¶

minutes¶

seconds¶

milliseconds¶

totalDays¶

totalHours¶

totalMinutes¶

totalSeconds¶

totalMilliseconds¶

add(timespan)¶

addDays(nbDays)¶

addHours(nbHours)¶

addMinutes(nbMinutes)¶

addSeconds(nbSeconds)¶

addMilliseconds(nbMillis)¶

Date format¶

The following table describes the custom date and time format specifiers that can be used with the datetime.format() function.

Format specifier	Description
y	The year, from 0 to 99.
yy	The year with leading zero (2 digits) from 00 to 99
yyy	The year, with a minimum of three digits. from 000 to 9999.
yyyy	The year as a four-digit number.
M	The month, from 1 through 12.
MM	The month with leading zero (2 digits) from 01 through 12.
MMM	The abbreviated name of the day of the month (Jan, Feb, Mar, Apr, May, June, July, Aug, Sept, Oct, Nov, Dec).
MMMM	The full name of the month (January, February, March, April, May, June, July, August, September, October, November, December).
d	The day of the month, from 1 through 31
dd	The day of the month with leading zero (2 digits) from 01 through 31.
ddd	The abbreviated name of the day of the week. (Mon, Tue, Wed, Thu, Fri, Sat, Sun)
dddd	The full name of the day of the week (Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday).
H	24-hour format of the hour, from 0 to 23.
HH	24-hour format of the hour with leading zero (2 digits) from 00 through 23.
h	12-hour format of the hour, from 1 to 12.
hh	12-hour format of the hour with leading zero (2 digits) from 01 through 12.
m	The minute, from 0 to 59.
mm	The minute with leading zero (2 digits) from 00 through 59.
s	The second, from 0 to 59.
ss	The second with leading zero (2 digits) from 00 through 59.
f	The tenths of a second from 0 to 9
ff	The hundredths of a second with leading zero (2 digits) from 00 to 99
fff	The milliseconds with leading zeros (3 digits) from 000 to 999
g, gg	The period or era (A.D. or B.C.)
t	The first character of AM/PM (A or P)
tt	Ante meridiem and Post meridiem (AM or PM)
\	Escape character. Used to introduce escape sequence.
other character	The character is copied unchanged.