Main Content

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

Zeitpunkte

datetimeArrays that represent points in time
dateshiftShift date or generate sequence of dates and times
NaTNot-a-Time
eomdayLast 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

yearsDuration in years
daysDuration in days
hoursDuration in hours
minutesDuration in minutes
secondsDuration in seconds
millisecondsDuration in milliseconds
durationLengths of time in fixed-length units

Kalenderdauer

calyearsCalendar duration in years
calquartersCalendar duration in quarters
calmonthsCalendar duration in months
calweeksCalendar duration in weeks
caldaysCalendar duration in days
calendarDurationLengths of time in variable-length calendar units

Monatskalender

calendarCalendar 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

Extrahieren von Komponenten

yearYear number of input date and time
quarterQuarter number of input date and time
monthMonth number or name of input date and time
weekWeek number of input date and time
dayDay number or name of input date and time
weekdayDay of week
hourHour component of input date and time
minuteMinute component of input date and time
secondSeconds component of input date and time
weeknum(Not recommended; use week) Week in year

Aufteilen in Komponenten

ymdYear, month, and day numbers of datetime
hmsHour, minute, and second numbers of datetime or duration
datevecConvert date and time to vector of components
splitSplit calendar duration into numeric and duration units
timeConvert time of calendar duration to duration
timeofdayElapsed time since midnight for datetime arrays

datetime Arrays

betweenCalendar math differences
caldiffCalendar math successive differences
tzoffsetTime zone offset from UTC
dateshiftShift 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
isbetweenDetermine elements within date and time interval
isregularDetermine if input times are regular with respect to time or calendar unit
isnatDetermine NaT (Not-a-Time) elements
isdstDetermine daylight saving time elements
isweekendDetermine weekend elements
isdatetimeDetermine if input is datetime array
isdurationDetermine if input is duration array
iscalendardurationDetermine if input is calendar duration array
stringString array
charCharacter array
datestr(Not recommended; use string or char) Convert date and time to string format

Konvertierungen

convertToConvert datetime values to numeric representations
exceltimeConvert MATLAB datetime to Excel date number
posixtimeConvert MATLAB datetime to POSIX time
juliandateConvert MATLAB datetime to Julian date
yyyymmddConvert 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

timezonesList time zones
leapsecondsList all leap seconds supported by datetime data type (Seit R2020a)
matlab.datetime.compatibility.convertDatenumConvert inputs to datetime values in a backward-compatible way (Seit R2022a)

Themen

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.