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 object that is set to the current date and time on this computer expressed as local time.

Return type: datetime

datetime.utcNow()¶

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

Return type: datetime

datetime.today()¶

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

Return type: datetime

datetime.isLeapYear(year)¶

Returns true if the year, given as an integer, is a leap year.

Return type: boolean

datetime.date(year, month, day)¶

Returns a new datetime object 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.

Return type: datetime

datetime.date(year, month, day, hour, minute, second)

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

Return type: datetime

datetime.span(nbHours, nbMinutes, nbSeconds)¶

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

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

Datetime¶

Represents an instant in time, expressed as a date and time of day.

type datetime¶

date¶

Returns the date component of the current datetime instance. The returned object has the same date as this instance, and its time component set to midnight (00:00:00.0).

Return type: datetime

year¶

Gets the year component of the date represented by this datetime instance.

Return type: int

month¶

Gets the month component of the date represented by this datetime instance. The month component is expressed as an integer between 1 and 12.

Return type: int

day¶

Gets the day of the month represented by this datetime instance. The day of the month is expressed as an integer between 1 and 31.

Return type: int

dayOfWeek¶

Gets the day of the week represented by this datetime instance. The day of the week is expressed as an integer between 1 and 7 where 1 represents Monday and 7 represents Sunday (according to ISO-8601 standard).

Return type: int

dayOfYear¶

Gets the day of the year represented by this datetime instance. The day of the year is expressed as an integer between 1 and 366.

Return type: int

hour¶

Gets the hour component of the date represented by this datetime instance. The hour component is expressed as an integer between 0 and 23.

Return type: int

minute¶

Gets the minute component of the date represented by this datetime instance. The minute component is expressed as an integer between 0 and 59.

Return type: int

second¶

Gets the second component of the date represented by this datetime instance. The second component is expressed as an integer between 0 and 59.

Return type: int

millisecond¶

Gets the millisecond component of the date represented by this datetime instance. The millisecond component is expressed as an integer between 0 and 999.

Return type: int

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.