Chaînes au format date et heure

Les chaînes de format servent de modèles pour la conversion d'une chaîne en une date, une heure ou une valeur d'horodatage, ou inversement. Les jetons suivants sont interprétés dans la chaîne de format fmt et permettent de lire les parties d'une valeur date, time ou datetime à partir d'une chaîne telle que StringToDate et StringToDateTime.

Formats de date

Token Valeur
yyyy Année en 4 chiffres (par exemple, 2012)
yy Année en 2 chiffres (par exemple, 12)
MMMM Nom du mois complet (par exemple, janvier)
MMM Abréviation du nom du mois (par exemple, jan)
mm 1 Mois exprimé par 2 chiffres (avec un zéro, si indiqué). Janvier = 01, Décembre = 12
m Mois exprimé par 1 ou 2 chiffres (sans zéro). Janvier = 1, Décembre = 12
dddd Nom complet du jour de la semaine (par exemple, mardi)
ddd Abréviation du nom du jour de la semaine (par exemple, Ma)
dd Jour du mois en 2 chiffres (commençant par un zéro, le cas échéant) (par ex. 04)
d Jour du mois en 1 ou 2 chiffres (sans zéro devant) (par ex. 4)

Lors de l'invocation de DateToString, la chaîne de format fmt peut contenir d'autres jetons et caractères qui sont transmis sans modification à la chaîne obtenue.

Exemples d'utilisation de chaînes de format de date

Étant donné la date du mardi 7 octobre 2003 comme valeur de l'argument date, les invocations suivantes de DateToString donnent les résultats indiqués.


  DateToString(date, 'mm-dd-yy')           : 10-07-03
  DateToString(date, 'm-d-yyyy')           : 10-7-2003
  DateToString(date, 'dddd, mmmm d, yyyy') : Tuesday, October 7, 2003
  DateToString(date, 'Today is dddd')      : Today is Tuesday
			

Les invocations suivantes de StringToDate donnent toutes une valeur de date pour le 7 octobre 2003.


  StringToDate('10/7/2003', 'm/d/yyyy')
  StringToDate('10-07-03', 'm-dd-yy')
  StringToDate('Today is 2003-Oct-03', 'Today is yyyy-mmm-dd')
			

Formats d'heure

Token Valeur
hh Heure en 2 chiffres (par exemple, 09)
mm 1 Minute en 2 chiffres (par exemple, 59)
ss Seconde en 2 chiffres (par exemple, 05)
tt AM ou PM (par ex. PM). Utilisez un t unique pour A ou P.
fff Fractions d'une seconde jusqu'à trois décimales (millisecondes). Les décimales supplémentaires sont tronquées.

Assurez-vous de fournir un formatage de date et d'heure en minuscules. Par exemple, pour représenter les heures, utilisez hh et non HH.

Si une colonne DateTime ou Time est utilisée seule dans une expression, celle-ci est formatée à l'aide des paramètres régionaux applicables.

Si une colonne DateTime ou Time est une expression, sa valeur de chaîne est TimeToNumber ou DateToNumber + espace + TimetoNumber.

Exemples d'utilisation de chaînes au format d'heure et d'horodatage

Étant donné l'heure 10:50:30 AM comme valeur de l'argument time, les invocations suivantes de TimeToString et de StringToTime donnent les résultats indiqués.


 TimeToString(time, 'hh:mm:ss tt')		        : 10:50:30 AM
 TimeToString(time, 'The time is hh:mm:ss tt')  : The time is 10:50:30 AM. 
 TimeToString(time, 'hh:mm:ss.fff tt")			: 10:50:30.333 AM
 StringToTime('10:50:30 AM', 'hh:mm:ss tt')
 StringToTime('The time is 10:50:30 AM', 'The time is hh:mm:ss tt')
 StringToTime('10:50:30.333 AM', 'hh:mm"ss.fff tt")
			

Les exemples suivants convertissent une date et une heure pour le 6 juillet 2012 10:50:30 AM en une chaîne et un horodatage.


StringToDateTime('07/06/2012 10:50:30 AM', 'mm/dd/yyyy hh:mm:ss tt')
DateTimeToString(StringToDateTime('07-06-2012 10:50:30 AM', 'mm-dd-yyyy hh:mm:ss tt'), 'mm-dd-yyyy hh:mm:ss tt')
1 Lorsque le mois et les minutes sont tous deux utilisés, le premier mm est considéré comme le mois. Pensez à utilisez le formatage de date et d'heure séparément pour éviter toute confusion.