Rubrique précédente: Valeurs maintenues dans la Version initiale d'un objet copiéRubrique suivante: Utilisation de masques pour spécifier des schémas dans des chaînes


Spécificateurs de formats de dates

CA Process Automation utilise des chaînes de schéma de format de date et d'heure Java standard. Dans des chaînes de schéma de date et d'heure, les lettres sans guillemets de "A" à "Z" et de "a" à "z" sont des lettres interprétées comme des lettres de schéma représentant les composants d'une chaîne de date ou d'heure. Vous pouvez utiliser des guillemets simples (') ou doubles (") pour éviter l'interprétation. "''" représente un guillemet simple. Tous les autres caractères ne sont pas interprétés ; ils sont copiés dans la chaîne de sortie pendant le formatage ou associés à la chaîne d'entrée pendant l'analyse.

Lettre

Composant de date ou d'heure

Présentation

Exemples

G

Marqueur d'époque

Texte

Apr. J.-C.

-y

Année

Année

2009; 09

M

Mois de l'année

Mois

Juillet ; 07

w

Semaine de l'année

Numéro

27

W

Semaine du mois

Numéro

2

D

Jour de l'année

Numéro

189

d

Jour du mois

Numéro

10

F

Jour de la semaine du mois

Numéro

2

E

Jour de la semaine

Texte

Mardi ; Mar.

a

Marqueur AM/PM

Texte

PM

H

Heure du jour (0-23)

Numéro

0

k

Heure du jour (1-24)

Numéro

24

K

Heure AM/PM (0-11)

Numéro

0

-h

Heure AM/PM (1-12)

Numéro

12

m

Minute de l'heure

Numéro

30

s

Seconde de la minute

Numéro

55

S

Milliseconde

Numéro

978

z

Fuseau horaire

Fuseau horaire général

Heure normale du Pacifique ; HNP ; GMT-08:00

Z

Fuseau horaire

Fuseau horaire RFC 822

-0800

Les schémas sont habituellement répétés ; leur numéro détermine la présentation exacte, comme illustré dans le tableau suivant :

Présentation

Formatage

Texte

Si le nombre de lettres du schéma est 4 ou plus, le formulaire complet est utilisé ; dans le cas contraire, un formulaire court ou abrégé est accepté, quel que soit le nombre de lettres du schéma.

Numéro

Le nombre de lettres du schéma est le nombre minimum de chiffres et les nombres plus courts sont complétés avec des zéros pour que tous les espaces soient utilisés. Pendant l'analyse, le nombre de lettres du schéma est ignoré, sauf s'il est nécessaire pour séparer deux champs contigus.

Année

Si le nombre de lettres du schéma est 2, l'année est tronquée à 2 chiffres ; dans le cas contraire, il est interprété comme un nombre.

Pendant l'analyse, si le nombre de lettres du schéma est supérieur à 2, l'année est interprétée littéralement, quel que soit le nombre de chiffres. Donc avec le schéma "MM/dd/yyyy", "11/01/12" analyse 11 janv. 12 Apr. J.-C.

Mois

Si le nombre de lettres du schéma est 3 ou plus, le mois est interprété comme texte ; dans le cas contraire, il est interprété comme nombre.

Fuseau horaire général

Les fuseaux horaires sont interprétés comme texte s'ils ont des noms. Pour des fuseaux horaires représentant une valeur de décalage par rapport à GMT, la syntaxe suivante est utilisée :

  • GMTOffsetTimeZone :
  • Heures : minutes GMT avec signe
  • Le signe peut être + ou -
  • Les heures doivent être comprises entre 0 et 23 et à l'un des formats suivants :

Chiffre

Chiffre chiffre

  • Les minutes doivent être comprises entre 00 et 59 et au format suivant :

Chiffre chiffre

  • Le chiffre est l'un des suivants :

0 1 2 3 4 5 6 7 8 9

Le format est indépendant des paramètres régionaux et doit être pris dans le bloc Latin de base de la norme Unicode.

Fuseau horaire RFC 822

Un format de fuseau horaire à quatre chiffres est utilisé :

  • RFC822TimeZone :

Signe Heureàdeuxchiffres Minutes

  • Heureàdeuxchiffres doit être compris entre 00 et 23. Les autres définitions sont les mêmes que pour les fuseaux horaires généraux.

SimpleDateFormat prend également en charge des chaînes de schéma de date et d'heure localisées. Dans ces chaînes, les lettres de schéma décrites ci-dessus peuvent être remplacées par d'autres lettres dépendant des paramètres régionaux et par des lettres de schéma. SimpleDateFormat ne s'occupe pas de la localisation de texte autre que les lettres de schéma ; c'est le client de la classe qui s'en occupe.

Les exemples suivants indiquent comment les schémas de date et d'heure sont interprétés dans les paramètres régionaux d'anglais US. La date et l'heure données sont 2009-07-04 12:08:56 au fuseau horaire Pacifique des Etats-Unis.

Schéma de date et d'heure.

Résultat

"yyyy.MM.dd G 'at' HH:mm:ss z"

2009.07.04 Apr. J.-C. à 12:08:56 PDT

"EEE, MMM d, ''yy"

Mer. 4 juil. 09

"h:mm a"

12:08 PM

"hh 'o''clock' a, zzzz"

12 heures PM, heure avancée du Pacifique

"K:mm a, z"

0:08, PDT

"yyyyy.MMMMM.dd GGG hh:mm aaa"

02009, 4 juillet Apr. J.-C. 12:08 PM

"EEE, d MMM yyyy HH:mm:ss Z"

Mer., 4 juil. 2009 12:08:56 -0700

"yyMMddHHmmssZ"

010704120856-0700

"yyyy-MM-dd'T'HH:mm:ss.SSSZ"

2009-07-04T12:08:56,235-0700