Formatage de la date et de l'heure
Cette section parle de la mise en forme de date et d'heure à des fins d'internationalisation.
Pourquoi et quand exécuter cette tâche
Formatage de la date
Le format de date présente le jour, le mois et l'année d'un système de calendrier particulier. Même lorsqu'un système de calendrier spécifique est envisagé, il n'existe pas de norme mondiale unique pour la présentation des informations relatives à la date. Différentes langues représentent des dates de différentes manières. Le tableau suivant répertorie certains des formats de date utilisés :
| Environnement local | Format courant | Format long | Format abrégé |
|---|---|---|---|
| Anglais (Etats-Unis) | 04/10/98 | April 10, 1998 | 04/10/98 |
| Chinois simplifié | 1998Year4Month10Day | 1998Year4Month10Day | 98-4-10 |
| Français | 10/04/1998 | 10 avril 1998 | 10/04/98 |
| Allemand | 10.4.98 | 10. April 1998 | 10.04.98 |
| Polonais | 10.04.1998 | 10 April 1998 | 10.04.98 |
| Roumain | 10.4.1998 | 10 April 1998 | 10.4.98 |
| Russe | 10.04.1998 | 10 April 1998 | 10.04.98 |
Voici les éléments du format de date qui rendent la date unique dans différentes régions du monde :
| Eléments | Description |
|---|---|
| Délimiteur de date | Les délimiteurs dans la représentation de la date diffèrent dans le monde entier. Voici quelques exemples de délimiteurs utilisés dans les dates :
|
| Ordre des composants de date | L'ordre du jour, du mois et de l'année diffère dans le monde entier. |
| Format de jour | Un zéro peut remplir le jour s'il s'agit d'un jour à un chiffre. |
| Format des mois | Le mois peut être numérique, abrégé ou entièrement épelé. |
| Formats des années | Le format de l'année peut avoir 2 chiffres ou 4 chiffres. |
Dans HCL Commerce, on utilise généralement le format court ou le format long. À l'aide de l'élément d'interface utilisateur de calendrier de la structure d'outils HCL Commerce, les développeurs peuvent afficher un calendrier à l'utilisateur et lui permettre d'entrer graphiquement ou manuellement une date. Cette date est ensuite retournée à la fenêtre d'appel et placée dans le champ correct. L'entrée de l'utilisateur est présentée dans des zones de texte. Étant donné que ces zones de texte ont des libellés qui leur sont attachés, il n'y a aucune ambiguïté quant à savoir quels chiffres sont respectivement l'année, le mois et le jour. Par conséquent, la mise en forme culturelle n'est pas nécessaire. La figure suivante affiche un exemple de calendrier incorporé dans HCL Commerce :
Format d'heure
Les formats utilisés pour l'heure diffèrent dans le monde entier. Même si un produit logiciel peut manipuler des informations temporelles à l'aide d'un horodatage, il doit afficher des informations temporelles à l'utilisateur, et en accepter de sa part, dans le contexte culturel approprié.
Le tableau suivant répertorie certains des formats d'heure utilisés :
| Environnement local | Format courant | Format long | Format abrégé |
|---|---|---|---|
| Anglais (Etats-Unis) | 2:45:16 PM | 2:45:16 PM EST | 2.45 PM |
| Chinois simplifié | 14:45:16 | 14hour45min16sec | 14:45 |
| Français | 14:45:16 | 14:45:16 | 14:45 |
| Allemand | 14:45:16 | 14:45:16 | 14:45 |
| Polonais | 14:45:16 | 14:45:16 | 14:45 |
| Roumain | 14:45:16 | 14:45:16 | 14:45 |
| Russe | 14:45:16 | 14:45:16 | 14:45 |
Voici les éléments du format d'heure qui rendent le format de l'heure unique dans différentes régions du monde :
| Eléments | Description |
|---|---|
| Délimiteur | Virgule ou point |
| Format | Certains pays affichent un zéro en tête des heures. |
| Format sur 24 heures | Certains pays utilisent le format 24 heures, tandis que d'autres comme les États-Unis utilisent le format 12 heures avec les indicateurs AM/PM. |
Dans la structure d'outils HCL Commerce, les fonctions utilisées pour valider les dates sont incluses dans le fichier JavaScript web/JavaScript/tools/common/DateUtil.js. Assurez-vous que ce fichier est inclus dans vos fichiers JSP.
Donnez toujours à l'utilisateur la possibilité de lancer un élément d'interface utilisateur de calendrier. Si les utilisateurs entrent la date manuellement, utilisez la fonction validDate (date) dans le fichier JavaScript DateUtil.js. La fonction validTime() se trouve dans le fichier JavaScript Util.js.
Dans HCL Commerce, la classe TimestampHelper fournit des fonctions de mise en forme de l'heure et de la date requises par les outils HCL Commerce et le développement du magasin.
La classe TimestampHelper() est disponible dans les packages com.ibm.commerce.utils (pour la structure d'outils) et com.ibm.commerce.ejb.helpers (pour l'exécution du serveur) pour aider à effectuer les conversions décrites dans le tableau suivant :
| De | A |
|---|---|
| Horodatage | Date en yyyy-mm-dd |
| Timestamp | Heure en hh:mm |
| Date et heure | Horodatage |
Par exemple, TimestampHelper.getDateFromTimestamp(Timestamp t,Locale locale) extrait la partie date de l'horodatage. La date est retournée d'une manière spécifique aux marchés locaux.
La plupart des beans de données HCL Commerce sont activés pour utiliser implicitement la fonctionnalité de mise en forme de date ou d'heure du TimestampHelper. L'exemple suivant décrit l'un de ces beans de données :
<%@page import="com.ibm.commerce.utils.TimestampHelper"%>
...
...
Timestamp currentTime = TimestampHelper.getCurrentTime();
String date = (String)
TimestampHelper.getDateFromTimestamp(currentTime, ${locale});
...
...