DateTimeFormatInfo Classe

Définition

Espace de noms:

System.Globalization

Assembly:

System.Runtime.dll

Source:

DateTimeFormatInfo.cs

Fournit des informations spécifiques à la culture sur le format des valeurs de date et d’heure.

public ref class DateTimeFormatInfo sealed : ICloneable, IFormatProvider

public sealed class DateTimeFormatInfo : ICloneable, IFormatProvider

type DateTimeFormatInfo = class
    interface ICloneable
    interface IFormatProvider

Public NotInheritable Class DateTimeFormatInfo
Implements ICloneable, IFormatProvider

Héritage

Object

DateTimeFormatInfo

Implémente

IFormatProvider ICloneable

Exemples

L’exemple suivant utilise la réflexion pour obtenir les propriétés de l’objet DateTimeFormatInfo pour la culture anglaise (États-Unis). Elle affiche la valeur de ces propriétés qui contiennent des chaînes de format personnalisées et utilise ces chaînes pour afficher les dates mises en forme.

using System;
using System.Globalization;
using System.Reflection;

public class Example
{
   public static void Main()
   {
      // Get the properties of an en-US DateTimeFormatInfo object.
      DateTimeFormatInfo dtfi = CultureInfo.GetCultureInfo("en-US").DateTimeFormat;
      Type typ = dtfi.GetType();
      PropertyInfo[] props = typ.GetProperties();
      DateTime value = new DateTime(2012, 5, 28, 11, 35, 0);

      foreach (var prop in props) {
         // Is this a format pattern-related property?
         if (prop.Name.Contains("Pattern")) {
            string fmt = prop.GetValue(dtfi, null).ToString();
            Console.WriteLine("{0,-33} {1} \n{2,-37}Example: {3}\n",
                              prop.Name + ":", fmt, "",
                              value.ToString(fmt));
         }
      }
   }
}
// The example displays the following output:
//    FullDateTimePattern:              dddd, MMMM dd, yyyy h:mm:ss tt
//                                         Example: Monday, May 28, 2012 11:35:00 AM
//
//    LongDatePattern:                  dddd, MMMM dd, yyyy
//                                         Example: Monday, May 28, 2012
//
//    LongTimePattern:                  h:mm:ss tt
//                                         Example: 11:35:00 AM
//
//    MonthDayPattern:                  MMMM dd
//                                         Example: May 28
//
//    RFC1123Pattern:                   ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
//                                         Example: Mon, 28 May 2012 11:35:00 GMT
//
//    ShortDatePattern:                 M/d/yyyy
//                                         Example: 5/28/2012
//
//    ShortTimePattern:                 h:mm tt
//                                         Example: 11:35 AM
//
//    SortableDateTimePattern:          yyyy'-'MM'-'dd'T'HH':'mm':'ss
//                                         Example: 2012-05-28T11:35:00
//
//    UniversalSortableDateTimePattern: yyyy'-'MM'-'dd HH':'mm':'ss'Z'
//                                         Example: 2012-05-28 11:35:00Z
//
//    YearMonthPattern:                 MMMM, yyyy
//                                         Example: May, 2012

Imports System.Globalization
Imports System.Reflection

Module Example
   Public Sub Main()
      ' Get the properties of an en-US DateTimeFormatInfo object.
      Dim dtfi As DateTimeFormatInfo = CultureInfo.GetCultureInfo("en-US").DateTimeFormat
      Dim typ As Type = dtfi.GetType()
      Dim props() As PropertyInfo = typ.GetProperties()
      Dim value As Date = #05/28/2012 11:35AM# 
      
      For Each prop In props
         ' Is this a format pattern-related property?
         If prop.Name.Contains("Pattern") Then
            Dim fmt As String = CStr(prop.GetValue(dtfi, Nothing))
            Console.WriteLine("{0,-33} {1} {2}{3,-37}Example: {4}", 
                              prop.Name + ":", fmt, vbCrLf, "",
                              value.ToString(fmt)) 
            Console.WriteLine()
         End If
      Next
   End Sub
End Module
' The example displays the following output:
'    FullDateTimePattern:              dddd, MMMM dd, yyyy h:mm:ss tt
'                                         Example: Monday, May 28, 2012 11:35:00 AM
'    
'    LongDatePattern:                  dddd, MMMM dd, yyyy
'                                         Example: Monday, May 28, 2012
'    
'    LongTimePattern:                  h:mm:ss tt
'                                         Example: 11:35:00 AM
'    
'    MonthDayPattern:                  MMMM dd
'                                         Example: May 28
'    
'    RFC1123Pattern:                   ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
'                                         Example: Mon, 28 May 2012 11:35:00 GMT
'    
'    ShortDatePattern:                 M/d/yyyy
'                                         Example: 5/28/2012
'    
'    ShortTimePattern:                 h:mm tt
'                                         Example: 11:35 AM
'    
'    SortableDateTimePattern:          yyyy'-'MM'-'dd'T'HH':'mm':'ss
'                                         Example: 2012-05-28T11:35:00
'    
'    UniversalSortableDateTimePattern: yyyy'-'MM'-'dd HH':'mm':'ss'Z'
'                                         Example: 2012-05-28 11:35:00Z
'    
'    YearMonthPattern:                 MMMM, yyyy
'                                         Example: May, 2012

Remarques

Pour plus d’informations sur cette API, consultez remarques d’API supplémentaires pour DateTimeFormatInfo.

Constructeurs

DateTimeFormatInfo()

Initialise une nouvelle instance accessible en écriture de la classe DateTimeFormatInfo indépendante de la culture (invariante).

Propriétés

AbbreviatedDayNames	Obtient ou définit un tableau unidimensionnel de type String contenant les noms abrégés propres à la culture des jours de la semaine.
AbbreviatedMonthGenitiveNames	Obtient ou définit un tableau de chaînes de noms de mois abrégés associés à l’objet DateTimeFormatInfo actuel.
AbbreviatedMonthNames	Obtient ou définit un tableau de chaînes unidimensionnel qui contient les noms abrégés propres à la culture des mois.
AMDesignator	Obtient ou définit l’indicateur de chaîne pendant les heures qui sont « ante meridiem » (avant midi).
Calendar	Obtient ou définit le calendrier à utiliser pour la culture actuelle.
CalendarWeekRule	Obtient ou définit une valeur qui spécifie la règle utilisée pour déterminer la première semaine civile de l’année.
CurrentInfo	Obtient un objet DateTimeFormatInfo en lecture seule qui met en forme les valeurs en fonction de la culture actuelle.
DateSeparator	Obtient ou définit la chaîne qui sépare les composants d’une date, c’est-à-dire l’année, le mois et le jour.
DayNames	Obtient ou définit un tableau de chaînes unidimensionnel qui contient les noms complets propres à la culture des jours de la semaine.
FirstDayOfWeek	Obtient ou définit le premier jour de la semaine.
FullDateTimePattern	Obtient ou définit la chaîne de format personnalisée pour une date longue et une valeur de longue durée.
InvariantInfo	Obtient l’objet DateTimeFormatInfo en lecture seule par défaut indépendant de la culture (invariant).
IsReadOnly	Obtient une valeur indiquant si l’objet DateTimeFormatInfo est en lecture seule.
LongDatePattern	Obtient ou définit la chaîne de format personnalisée pour une valeur de date longue.
LongTimePattern	Obtient ou définit la chaîne de format personnalisée pour une valeur de longue durée.
MonthDayPattern	Obtient ou définit la chaîne de format personnalisée pour une valeur de mois et de jour.
MonthGenitiveNames	Obtient ou définit un tableau de chaînes de noms de mois associé à l’objet DateTimeFormatInfo actuel.
MonthNames	Obtient ou définit un tableau unidimensionnel de type String contenant les noms complets propres à la culture des mois.
NativeCalendarName	Obtient le nom natif du calendrier associé à l’objet DateTimeFormatInfo actuel.
PMDesignator	Obtient ou définit l’indicateur de chaîne pendant des heures qui sont « post meridiem » (après midi).
RFC1123Pattern	Obtient la chaîne de format personnalisée pour une valeur de temps basée sur la spécification IETF (Internet Engineering Task Force) Request for Comments (RFC) 1123.
ShortDatePattern	Obtient ou définit la chaîne de format personnalisée pour une valeur de date courte.
ShortestDayNames	Obtient ou définit un tableau de chaînes des noms de jour abrégés les plus courts associés à l’objet DateTimeFormatInfo actuel.
ShortTimePattern	Obtient ou définit la chaîne de format personnalisée pour une valeur de courte durée.
SortableDateTimePattern	Obtient la chaîne de format personnalisée pour une valeur de date et d’heure triable.
TimeSeparator	Obtient ou définit la chaîne qui sépare les composants du temps, c’est-à-dire l’heure, les minutes et les secondes.
UniversalSortableDateTimePattern	Obtient la chaîne de format personnalisée pour une chaîne de date et d’heure universelle, triable, telle que définie par ISO 8601.
YearMonthPattern	Obtient ou définit la chaîne de format personnalisée pour une valeur d’année et de mois.

Méthodes

Clone()	Crée une copie superficielle du DateTimeFormatInfo.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetAbbreviatedDayName(DayOfWeek)	Retourne le nom abrégé spécifique à la culture du jour spécifié de la semaine en fonction de la culture associée à l’objet DateTimeFormatInfo actuel.
GetAbbreviatedEraName(Int32)	Retourne la chaîne contenant le nom abrégé de l’ère spécifiée, si une abréviation existe.
GetAbbreviatedMonthName(Int32)	Retourne le nom abrégé spécifique à la culture du mois spécifié en fonction de la culture associée à l’objet DateTimeFormatInfo actuel.
GetAllDateTimePatterns()	Retourne tous les modèles standard dans lesquels les valeurs de date et d’heure peuvent être mises en forme.
GetAllDateTimePatterns(Char)	Retourne tous les modèles dans lesquels les valeurs de date et d’heure peuvent être mises en forme à l’aide de la chaîne de format standard spécifiée.
GetDayName(DayOfWeek)	Retourne le nom complet spécifique à la culture du jour spécifié de la semaine en fonction de la culture associée à l’objet DateTimeFormatInfo actuel.
GetEra(String)	Retourne l’entier représentant l’ère spécifiée.
GetEraName(Int32)	Retourne la chaîne contenant le nom de l’ère spécifiée.
GetFormat(Type)	Retourne un objet du type spécifié qui fournit un service de mise en forme de date et d’heure.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetInstance(IFormatProvider)	Retourne l’objet DateTimeFormatInfo associé au IFormatProviderspécifié.
GetMonthName(Int32)	Retourne le nom complet spécifique à la culture du mois spécifié en fonction de la culture associée à l’objet DateTimeFormatInfo actuel.
GetShortestDayName(DayOfWeek)	Obtient le nom de jour abrégé le plus court pour un jour spécifié de la semaine associé à l’objet DateTimeFormatInfo actuel.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ReadOnly(DateTimeFormatInfo)	Renvoie un wrapper DateTimeFormatInfo en lecture seule.
SetAllDateTimePatterns(String[], Char)	Définit les chaînes de format de date et d’heure personnalisées qui correspondent à une chaîne de format standard spécifiée.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Voir aussi

• DateTime
• Calendar
• CultureInfo