System.TDateTime.FormatString
C++
System::String FormatString(const System::String& format) const;
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | systdate.h | System | TDateTime |
Description
Formate l'objet TDateTime en utilisant le format spécifié.
Les spécificateurs de format suivants sont supportés :
| Spécificateur | Affichage |
|---|---|
| c | Affiche la date, en utilisant le format défini par la variable globale ShortDateFormat, puis l'heure, en utilisant le format défini par la variable globale LongTimeFormat. L'heure n'est pas affichée si la partie fractionnaire de DateTime est égale à zéro. |
| d | Affiche le numéro du jour sans le préfixer d'un zéro (1 à 31). |
| dd | Affiche le numéro du jour en le préfixant d'un zéro (01 à 31). |
| ddd | Affiche le jour abrégé (Dim à Sam) en utilisant les chaînes fournies par la variable globale ShortDayNames. |
| dddd | Affiche le jour complet (Dimanche à Samedi) en utilisant les chaînes fournies par la variable globale LongDayNames. |
| ddddd | Affiche la date en utilisant le format fourni par la variable globale ShortDateFormat. |
| dddddd | Affiche la date en utilisant le format fourni par la variable globale LongDateFormat. |
| m | Affiche le numéro du mois sans le préfixer d'un zéro (1 à 12). Si le spécificateur m suit immédiatement un spécificateur h ou hh, les minutes sont affichées plutôt que le numéro du mois. |
| mm | Affiche le numéro du mois en le préfixant d'un zéro (01 à 12). Si le spécificateur mm suit immédiatement un spécificateur h ou hh, il provoque l'affichage des minutes plutôt que du numéro du mois. |
| mmm | Affiche le mois abrégé (Jan à Déc) en utilisant les chaînes fournies par la variable globale ShortMonthNames. |
| mmmm | Affiche le mois complet (Janvier à Décembre) en utilisant les chaînes fournies par la variable globale LongMonthNames. |
| yy | Affiche le numéro de l'année sous la forme de deux chiffres (00 à 99). |
| yyyy | Affiche l'année sous la forme de quatre chiffres (0000-9999). |
| h | Affiche l'heure sans la préfixer d'un zéro (0 à 23). |
| hh | Affiche l'heure en la préfixant d'un zéro (00 à 23). |
| n | Affiche les minutes sans les préfixer d'un zéro (0 à 59). |
| nn | Affiche les minutes en les préfixant d'un zéro (00 à 59). |
| s | Affiche les secondes sans les préfixer d'un zéro (0 à 59). |
| ss | Affiche les secondes en les préfixant d'un zéro (00 à 59). |
| t | Affiche l'heure en utilisant le format fourni par la variable globale ShortTimeFormat. |
| tt | Affiche l'heure en utilisant le format fourni par la variable globale LongTimeFormat. |
| am/pm | Utilise le format sur 12 heures avec le spécificateur h ou hh qui le précède et affiche 'am' pour les heures avant midi et 'pm' pour les heures après midi. Le spécificateur am/pm peut utiliser indifféremment les majuscules ou les minuscules. |
| a/p | Utilise le format sur 12 heures avec le spécificateur h ou hh qui le précède et affiche 'a' pour les heures avant midi et 'p' pour les heures après midi. Le spécificateur a/p peut utiliser indifféremment des majuscules ou des minuscules ; l'affichage s'effectuera en conséquence |
| ampm | Utilise le format sur 12 heures avec le spécificateur h ou hh qui le précède et affiche le contenu de la variable globale TimeAMString pour les heures avant midi et le contenu de la variable globale TimePMString pour les heures après midi. |
| / | Affiche le caractère de séparation de date fourni par la variable globale DateSeparator. |
| : | Affiche le séparateur des heures fourni par la variable globale TimeSeparator. |
| 'xx'/"xx" | Les caractères entre apostrophes ou guillemets sont affichés tels quels et n'affectent pas le formatage. |
Si la chaîne donnée par le paramètre format est vide, la valeur TDateTime est formatée comme si le format spécifié était c.
Exemple de code
#include <tchar.h>
#include <stdio.h>
#include <System.hpp>
int _tmain(int argc, _TCHAR* argv[])
{
//Initialize a new instance of TDateTime with the current time.
TDateTime* myTime = new TDateTime(Now());
String S = "The current date is: " + myTime->FormatString("dddd mmmm d, yyyy\n") + "The current time is: " + myTime->FormatString("hh:mm:zz AM/PM");
printf("%ls\n", S.c_str());
/* ShowMessage(S); // FireMonkey, VCL applications and Unicode characters */
return 0;
}
Sortie de l'exemple
The current date is: Wednesday October 9, 2013 The current time is: 02:09:511 PM