Main Content

La traduction de cette page n'est pas à jour. Cliquez ici pour voir la dernière version en anglais.

Dates et heures

Tableaux de dates et d’heures pouvant être affichés dans différents formats

Les types de données de date et d’heure datetime, duration et calendarDuration permettent le calcul, la comparaison et l’affichage formaté efficaces des dates et des heures. Ces tableaux s’utilisent de la même manière que les tableaux numériques. Vous pouvez ajouter, soustraire, trier, comparer, concaténer et représenter graphiquement des valeurs de date et d’heure. Vous pouvez également représenter des dates et des heures sous forme de tableaux numériques ou de texte. Pour plus d’informations, consultez Represent Dates and Times in MATLAB ou regardez la vidéo Date and Time Arrays (Tableaux de dates et d’heures).

Fonctions

développer tout

Moments dans le temps

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

Durées

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

Durées calendaires

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

Calendrier du mois

calendarCalendar for specified month

Moments dans le temps dans d’autres formats

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

Extraire des composants

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

Séparer en composants

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

Tableaux datetime

betweenCalendar math differences
caldiffCalendar math successive differences
tzoffsetTime zone offset from UTC
dateshiftShift date or generate sequence of dates and times

Tableaux à format fixe

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

Conversions

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

Heures dans MATLAB

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

Rubriques

Résolution des problèmes

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.