COleDateTime::Format

Format de CString (DWORD dwFlags = 0, LCID lcid = LANG_USER_DEFAULT);

Format de CString (LPCTSTR lpszFormat ) const ;

Format de CString (UINT nFormatID ) const ;

Valeur de retour

Une CString qui contient la valeur de date / d'heure au format.

Paramètres

dwFlags

Indique les drapeaux pour les paramètres régionaux, peut-être l'indicateur suivant:

• LOCALE_&NOUSEROVERRIDEnbsp ;  Utiliser les paramètres des paramètres régionaux par défaut du système, plutôt que des paramètres utilisateur personnalisés.
  
  
• VAR_TIMEVALUEO&NLYnbsp ;  Ne pas tenir compte de la partie de date lors de l'analyse.
  
  
• VAR_DATEVALUEO&NLYnbsp ;  Ne pas tenir compte de la portion de temps lors de l'analyse.

lcid

Indique l'ID de paramètres régionaux à utiliser pour la conversion.

lpszFormat

Une chaîne mise en forme semblable à la printf mise en forme de chaîne. Les codes de mise en forme, précédés par un signe pourcentage (%), sont remplacées par le composant COleDateTime correspondant. Autres caractères dans la chaîne mise en forme sont copiés inchangée de la chaîne retournée. Voir la fonction run-time strftime pour plus de détails. La valeur et la signification des codes de mise en forme de Format sont énumérés ci-dessous

• %H  ;  Heures dans la journée actuelle
  
  
• %M  ;  Minutes à l'heure actuelle
  
  
• %S  ;  Secondes dans la minute en cours
  
  
• %  ;  Signe de pourcentage

nFormatID

L'ID de ressource pour la chaîne de format de contrôle.

Remarques

Appelez cette fonction membre pour créer une représentation mise en forme de la valeur de date/heure. Si l'état de cet objet COleDateTime est null, la valeur de retour est une chaîne vide. Si le statut est invalid, la chaîne de retour est spécifiée par la ressource de chaîne IDS_INVALID_DATETIME.

Suit une brève description des trois formes de cette fonction:

Format ( dwFlags, lcid )

Cette forme met en forme la valeur en utilisant les spécifications de la langue nationale (ID de paramètres régionaux) pour date/heure. En utilisant les paramètres par défaut, ce formulaire sera imprimé une fois seulement si la partie « date » de la valeur de date/heure est date 0 (30 décembre 1899). De même, avec les paramètres par défaut, cette forme imprimera une date que si la portion de temps de la valeur de date/heure est temps 0 (minuit). Si la valeur de date/heure est 0 (30 décembre 1899, minuit), cette forme avec les paramètres par défaut sera imprimé à minuit.

Format ( lpszFormat )

Cette forme en forme la valeur à l'aide de la chaîne de format qui contient la mise en forme des codes spéciaux qui sont précédés d'un signe pourcentage (%), comme dans le printf. La chaîne mise en forme est passée comme paramètre à la fonction. Pour plus d'informations sur les codes de mise en forme, voir strftime, wcsftime dans la Référence de la bibliothèque Run-Time.

Format ( nFormatID )

Cette forme en forme la valeur à l'aide de la chaîne de format qui contient la mise en forme des codes spéciaux qui sont précédés d'un signe pourcentage (%), comme dans le printf. La chaîne mise en forme est une ressource. L'ID de ressource de cette chaîne est passée comme paramètre. Pour plus d'informations sur les codes de mise en forme, voir strftime, wcsftime dans la Référence de la bibliothèque Run-Time.

Pour une liste de valeurs d'ID de paramètres régionaux, consultez la section Soutenir plusieurs langues nationales dans le Win32 SDK OLE de référence du programmeur.

Aperçu COleDateTime |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;COleDateTime::ParseDateTime, COleDateTime::GetStatus