Die Übersetzung dieser Seite ist veraltet. Klicken Sie hier, um die neueste Version auf Englisch zu sehen.

Datum und Uhrzeit

Datums- und Uhrzeitarrays mit Anzeige in verschiedenen Formaten

Die Datentypen für Datum und Uhrzeit datetime, duration und calendarDuration unterstützen effiziente Berechnungen, Vergleiche und die formatierte Anzeige von Datum und Uhrzeit. Arbeiten Sie mit diesen Arrays genauso wie mit numerischen Arrays. Sie können Datums- und Uhrzeitwerte hinzufügen, subtrahieren, sortieren, vergleichen, verknüpfen und grafisch darstellen. Sie können auch Datum und Uhrzeit als numerische Arrays oder Text darstellen. Weitere Informationen finden Sie unter Represent Dates and Times in MATLAB oder sehen Sie sich Datums- und Uhrzeitarrays an.

Funktionen

alle erweitern

Erstellen von Datums- und Uhrzeitarrays

Zeitpunkte

`datetime`	Arrays that represent points in time
`dateshift`	Shift date or generate sequence of dates and times
`NaT`	Not-a-Time
`eomday`	Last day of month
`lweekdate`	(Not recommended; use `dateshift`) Date of last occurrence of weekday in month
`nweekdate`	(Not recommended; use `dateshift`) Date of specific occurrence of weekday in month

Dauer

`years`	Duration in years
`days`	Duration in days
`hours`	Duration in hours
`minutes`	Duration in minutes
`seconds`	Duration in seconds
`milliseconds`	Duration in milliseconds
`duration`	Lengths of time in fixed-length units

Kalenderdauer

`calyears`	Calendar duration in years
`calquarters`	Calendar duration in quarters
`calmonths`	Calendar duration in months
`calweeks`	Calendar duration in weeks
`caldays`	Calendar duration in days
`calendarDuration`	Lengths of time in variable-length calendar units

Monatskalender

calendar Calendar for specified month

Zeitpunkte in alternativen Formaten

`datenum`	(Not recommended; use `datetime` or `duration`) Convert date and time to serial date number
`now`	(Not recommended; use `datetime`) Current date and time as serial date number
`clock`	(Not recommended; use `datetime`) Current date and time as date vector
`date`	(Not recommended; use `datetime("today")`) Current date as character vector
`today`	(Not recommended; use `datetime("today")`) Current date
`eomdate`	(Not recommended; use `dateshift`) Last date of month

Datums- und Uhrzeitkomponenten

Extrahieren von Komponenten

`year`	Year number of input date and time
`quarter`	Quarter number of input date and time
`month`	Month number or name of input date and time
`week`	Week number of input date and time
`day`	Day number or name of input date and time
`weekday`	Day of week
`hour`	Hour component of input date and time
`minute`	Minute component of input date and time
`second`	Seconds component of input date and time
`weeknum`	(Not recommended; use `week`) Week in year

Aufteilen in Komponenten

`ymd`	Year, month, and day numbers of datetime
`hms`	Hour, minute, and second numbers of datetime or duration
`datevec`	Convert date and time to vector of components
`split`	Split calendar duration into numeric and duration units
`time`	Convert time of calendar duration to duration
`timeofday`	Elapsed time since midnight for `datetime` arrays

Berechnen von Differenzen oder Verschieben von Daten

`datetime`-Arrays

`between`	Calendar math differences
`caldiff`	Calendar math successive differences
`tzoffset`	Time zone offset from UTC
`dateshift`	Shift date or generate sequence of dates and times

Arrays mit festem Format

`addtodate`	(Not recommended; use `duration` or `calendarDuration`) Add time to serial date number
`etime`	(Not recommended; use `datetime` values or `between`) Time elapsed between date vectors
`months`	(Not recommended; use `between`) Number of whole months between dates

Abfragen von Array-Inhalten

`isbetween`	Determine which elements are within specified range
`isregular`	Determine if input times are regular with respect to time or calendar unit
`isnat`	Determine NaT (Not-a-Time) elements
`isdst`	Determine daylight saving time elements
`isweekend`	Determine weekend elements
`isdatetime`	Determine if input is datetime array
`isduration`	Determine if input is duration array
`iscalendarduration`	Determine if input is calendar duration array

Konvertieren in Text

`string`	String array
`char`	Character array
`datestr`	(Not recommended; use `string` or `char`) Convert date and time to string format

Excel, POSIX und andere Datums- und Uhrzeit-Systeme

Konvertierungen

`convertTo`	Convert `datetime` values to numeric representations
`exceltime`	Convert MATLAB datetime to Excel date number
`posixtime`	Convert MATLAB datetime to POSIX time
`juliandate`	Convert MATLAB datetime to Julian date
`yyyymmdd`	Convert MATLAB datetime to YYYYMMDD numeric value
`m2xdate`	(Not recommended; use `exceltime`) MATLAB date to Excel serial date number
`x2mdate`	(Not recommended; use `datetime`) Excel serial date number to MATLAB serial date number or `datetime` value

Uhrzeiten in MATLAB

`timezones`	List all time zones
`leapseconds`	List all leap seconds supported by `datetime` data type (Seit R2020a)

Abwärtskompatibilität

matlab.datetime.compatibility.convertDatenum Convert inputs to datetime values in a backward-compatible way (Seit R2022a)

Themen

Represent Dates and Times in MATLAB

Use datetime arrays to store date and time information. These arrays support arithmetic, sorting, comparisons, plotting, and formatted display.
Replace Discouraged Instances of Serial Date Numbers and Date Strings
As of R2022b, serial date numbers and date strings are not recommended for specifying dates and times. Use the datetime, duration, and calendarDuration data types instead. Follow these recommendations for updating your code.
Compare Dates and Time

Compare dates, times, and durations by using relational operators, such as >, <, and ==, taking time zones and daylight saving time into account.
- Date and Time Arithmetic
- Plot Dates and Times
Set Date and Time Display Format
The Format property on datetime, duration, and calendarDuration arrays controls the display of values in each array. You can change the value of this property. Changing the Format property does not change the values in the array, only their display.
Specify Time Zones

Specify time zones for datetime arrays to account for time zone offsets, daylight saving time, or leap seconds.
- Convert Date and Time to Julian Date or POSIX Time
Share Code and Data Across Locales
Follow these best practices when sharing code that handles dates and time with MATLAB^® users in other locales. Write and read dates from other locales.
Core Functions Supporting Date and Time Arrays
Many functions in MATLAB operate on date and time arrays in much the same way that they operate on other arrays.

Fehlersuche

Carryover in Date Vectors and Strings

If an element falls outside the conventional range, MATLAB adjusts both that date vector element and the previous element.

Converting Date Vector Returns Unexpected Output

Because a date vector is a 1-by-6 vector of numbers, datestr might interpret your input date vectors as vectors of serial date numbers—or interpret serial date numbers as date vectors—and return unexpected output.