Les littéraux

Introduction

Les littéraux sont utilisés :

• comme valeur d'initiaslisation.

• comme opérande dans une expression. Une expression peut servir de valeur d'initialisation.

Nous décrirons les  littéraux en détaillant les 4  classificateurs de base des types de données :

• logique ou booléan.

• textuel ou chaîne de caractères.

• numérique.

• temporel.

Type logique (boolean)

Pour le type logique (boolean), deux valeurs sont possible :

• True

• False

Pour une saisie en mode Littéral, les 2 valeurs du type logique sont présentées dans une liste déroulante.

Pour une saisie en mode Littéral, les valeurs de type logique doivent être saisie selon la préférence Localisation | Booléens | Format d'écriture.

Type textuel (chaîne de caractères)

Types descendants de string

Généralités

Les caractères autorisés sont : 

_0-9a-zA-ZàâäçéèêëòöôùûüÀÂÄÇÉÈÊËÒÖÔÙÛÜ

Si la propriété  Maj. {uppercase} de l'attribut est vrai, seuls les caractères majuscules sont autorisés. 

Pour les informaticiens :  En mode de saisie Littéral les caractères saisis ne doivent pas être entourées de guillemets ou double guillements

token

L'espace est autorisé dans le type token pour séparer les mots.

word

Type numérique

Type entier (integer)

Les nombres entiers sont une suite de chiffres qui peuvent être précédés du signe moins (-).
Le signe (-) n'est pas compté pour la longueur maximale.

La préférence Localisation | Nombre | Séparateur milliers pemet de définir un éventuel séparateur de milliers.

L'autorisation de nombres entiers peut être retreinte en fonction des différents sous-types.

Type décimal (decimal)

Les nombres décimaux sont une suite de chiffres qui peuvent :

•  être précédés du signe moins (-);

• comporter un et un seul point entre 2 chiffres.

Les signes (-) et (.) ne sont pas comptés pour la longueur maximale.
La longueur maximale est l'addition des chiffres de la partie entière et de la partie décimale.

La préférence Localisation | Nombre | Séparateur décimales pemet de définitir le séparateur de décimales.

L'autorisation de nombres décimaux peut être retreinte en fonction des différents sous-types.

Type monétaire

Le type monétaire se comporte est une sorte de spécialisation du type nombre décimal.
Ce qui le distingue du type nombre décimal c'est que le séparateur de millier peut lui être spécifique.

La préférence Localisation | Monétaire | Séparateur milliers pemet de définitir un séparateur de milliers éventuellement distinct de celui des nombres.

Type temporel

Généralités

Les prinicpes généraux sont repris de la norme ISO 8601.

Pour les particularité la préférence Localisation | Dates et Instants permet de choisir un fonctionnement du logiciel conformes aux pratiques locales.

date

Une date est saisie sous forme d'une chaine de caractères composée de :

• 2 chiffres pour le jour (D);

• 2 chiffres pour le mois (M);

• 4 chiffres pour l'année (Y).

• 1 séparateur entre les éléments de natures différentes {jour, mois, année}

Si les préférences de localisation sont  DD.MM.YYYY, la chaîne de caractères  20.01.2026 est une date  conforme.

La date ci-dessus au format ISO 8106  YYYY-MM-DD aurait la forme suivante : 2026-01-20

time

La forme littérale doit respecter le format ISO 8601  HH:MM:SS soit :

• 2 chiffres de 00 à 23 pour les heures (H);

• 2 chiffres de 00 à 59 pour les minutes (M);

• aucun chiffre ou 2 chiffres de 00 à 59 pourles secondes (S).

Par exemple :

• 00:00 ou 00:00:00

• 00:10 

• 00:00:40

• 23:50:40

dateTime

La forme littérale est composée d'une date, d'un séparateur et d'un instant.

• La date doit être saisie comme indiqué pourle type date.

• L'instant doit être saisi comme indiqué pour le type time.

• Le séparateur doit être saisi selon la préférence de localisation.

duration

La forme littérale doit respecter le format ISO 8601  P [nY] [nM] [nD] [T [nH] [nM] [nS]] ou PnW.

• P - Obligatoire, indique une période ou durée. 

Pour la première variante :

• nY - Un nombre d'années optionnel

• nM - Un nombre de mois optionnel

• nD - Un nombre de jours optionnel

• T - Optionnel, mais obligatoire pour introduire des éléments temporels

• nH - Un nombre d'heures optionnel

• nM - Un nombre de minutes optionnel

• nS - Un nombre de secondes optionnel

Pour la première variante :

• nW - Un nombre de semaines

Par exemple :

• P1Y20D - 1 année et 10 jours

• P3DT12H - 3 jours et 12 heures

• P5W - 5 semaines

Les types du w3c

Référence : https://www.w3.org/TR/xmlschema-2/

gYear

Le format recommandé par le W3C pour saisir une année est YYYY
MVCCD limite la plage de validité YYYY entre 1000 et 2999

gYearMonth

Le format recommandé par le W3C pour saisir une année et un mois est YYYY-MM
MM est valide entre 01et 12

gMonth

Le format recommandé par le W3C pour saisir une année et un mois est --MM
MM est valide entre 01et 12

gMonthDay

Le format recommandé par le W3C pour saisir un mois et un jour est --MM-DD
MM est valide entre 01et 12
DD est valide entre 01 et 31 voir 30 ou 29 selon les mois

gDay

Le format recommandé par le W3C pour un jour est ---DD
DD est valide entre 01 et 31