---

8.2.9 datetime ¶

Class: datetime ¶

Represents points in time using the Gregorian calendar.

The underlying values are doubles representing the number of days since the Matlab epoch of "January 0, year 0". This has a precision of around nanoseconds for typical times.

A datetime array is an array of date/time values, with each element holding a complete date/time. The overall array may also have a TimeZone and a Format associated with it, which apply to all elements in the array.

This is an attempt to reproduce the functionality of Matlab’s datetime. It also contains some Octave-specific extensions.

Instance Variable of datetime: double dnums ¶

The underlying datenums that represent the points in time. These are always in UTC.

This is a planar property: the size of dnums is the same size as the containing datetime array object.

Instance Variable of datetime: char TimeZone ¶

The time zone this datetime array is in. Empty if this does not have a time zone associated with it (“unzoned”). The name of an IANA time zone if this does.

Setting the TimeZone of a datetime array changes the time zone it is presented in for strings and broken-down times, but does not change the underlying UTC times that its elements represent.

Instance Variable of datetime: char Format ¶

The format to display this datetime in. Currently unsupported.

• datetime.datetime
• datetime.ofDatenum
• datetime.ofDatestruct
• datetime.NaT
• datetime.posix2datenum
• datetime.datenum2posix
• datetime.proxyKeys
• datetime.ymd
• datetime.hms
• datetime.ymdhms
• datetime.timeofday
• datetime.week
• datetime.dispstrs
• datetime.datestr
• datetime.datestrs
• datetime.datestruct
• datetime.posixtime
• datetime.datenum
• datetime.gmtime
• datetime.localtime
• datetime.isnat
• datetime.isnan
• datetime.lt
• datetime.le
• datetime.ne
• datetime.eq
• datetime.ge
• datetime.gt
• datetime.plus
• datetime.minus
• datetime.diff
• datetime.isbetween
• datetime.linspace
• datetime.convertDatenumTimeZone