DateTimeFormatInfo Classe

Définition

Fournit des informations propres à une culture sur le format des valeurs de date et d'heure.

public ref class DateTimeFormatInfo sealed : IFormatProvider
public ref class DateTimeFormatInfo sealed : ICloneable, IFormatProvider
public ref class DateTimeFormatInfo sealed : ICloneable, IFormatProvider, System::Runtime::Serialization::ISerializable
public sealed class DateTimeFormatInfo : IFormatProvider
public sealed class DateTimeFormatInfo : ICloneable, IFormatProvider
[System.Serializable]
public sealed class DateTimeFormatInfo : ICloneable, IFormatProvider, System.Runtime.Serialization.ISerializable
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class DateTimeFormatInfo : ICloneable, IFormatProvider
type DateTimeFormatInfo = class
    interface IFormatProvider
type DateTimeFormatInfo = class
    interface ICloneable
    interface IFormatProvider
[<System.Serializable>]
type DateTimeFormatInfo = class
    interface ICloneable
    interface IFormatProvider
    interface ISerializable
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type DateTimeFormatInfo = class
    interface ICloneable
    interface IFormatProvider
Public NotInheritable Class DateTimeFormatInfo
Implements IFormatProvider
Public NotInheritable Class DateTimeFormatInfo
Implements ICloneable, IFormatProvider
Public NotInheritable Class DateTimeFormatInfo
Implements ICloneable, IFormatProvider, ISerializable
Héritage
DateTimeFormatInfo
Attributs
Implémente

Exemples

L’exemple suivant utilise la réflexion pour obtenir les propriétés de l’objet DateTimeFormatInfo pour la culture anglaise (États-Unis). Il affiche la valeur des 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 supplémentaires sur l’API pour DateTimeFormatInfo.

Constructeurs

DateTimeFormatInfo()

Initialise une nouvelle instance accessible en écriture de la classe DateTimeFormatInfo qui est indépendante de la culture (dite indifférente).

Propriétés

AbbreviatedDayNames

Obtient ou définit un tableau unidimensionnel de type String contenant les noms abrégés spécifiques de la culture des jours de la semaine.

AbbreviatedMonthGenitiveNames

Obtient ou définit un tableau de chaînes des noms de mois abrégés associés à l’objet DateTimeFormatInfo actuel.

AbbreviatedMonthNames

Obtient ou définit un tableau de chaînes unidimensionnel contenant les noms abrégés spécifiques à la culture des mois.

AMDesignator

Obtient ou définit l'indicateur de chaîne pour les heures du matin (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 à utiliser pour déterminer la première semaine du calendrier 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 spécifiques à 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 valeur de date longue et une valeur d'heure longue.

InvariantInfo

Obtient l’objet DateTimeFormatInfo en lecture seule par défaut qui est 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 d'heure longue.

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és à l’objet DateTimeFormatInfo actuel.

MonthNames

Obtient ou définit un tableau unidimensionnel de type String contenant les noms complets spécifiques de la culture des mois.

NativeCalendarName

Obtient le nom natif du calendrier associé à l’objet DateTimeFormatInfo actuel.

PMDesignator

Obtient ou définit le désignateur de chaîne pour les heures de l'après-midi.

RFC1123Pattern

Obtient la chaîne de format personnalisée pour une valeur d’heure qui est basée sur la spécification RFC (Request for Comments) 1123 (RFC) de l’IETF (Internet Engineering Task Force).

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 jours abrégés uniques les plus courts associés à l’objet DateTimeFormatInfo actuel.

ShortTimePattern

Obtient ou définit la chaîne de format personnalisée pour une valeur d'heure courte.

SortableDateTimePattern

Obtient la chaîne de format personnalisée pour une valeur de date et d'heure pouvant être triée.

TimeSeparator

Obtient ou définit la chaîne qui sépare les composants de l'heure, 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 pouvant être triée, comme défini 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 de 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 de la culture du jour de la semaine spécifié en fonction de la culture associée à l’objet DateTimeFormatInfo actuel.

GetAbbreviatedEraName(Int32)

Retourne une 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 de la culture du mois spécifié en fonction de la culture associée à l’objet DateTimeFormatInfo actuel.

GetAllDateTimePatterns()

Retourne tous les modèles standard selon lesquels un format peut être appliqué aux valeurs de date et d’heure.

GetAllDateTimePatterns(Char)

Retourne tous les modèles dans lesquels les valeurs de date et d’heure peuvent être mises en forme en utilisant la chaîne de format standard.

GetDayName(DayOfWeek)

Retourne le nom complet spécifique de la culture du jour de la semaine spécifié 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()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetInstance(IFormatProvider)

Retourne l’objet DateTimeFormatInfo associé à l’élément IFormatProvider spécifié.

GetMonthName(Int32)

Retourne le nom complet spécifique de 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 de la semaine spécifié associé à l’objet DateTimeFormatInfo actuel.

GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
ReadOnly(DateTimeFormatInfo)

Retourne un wrapper DateTimeFormatInfo en lecture seule.

SetAllDateTimePatterns(String[], Char)

Définit les chaînes de format personnalisé de date et d'heure 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)

Implémentations d’interfaces explicites

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Renseigne un objet SerializationInfo avec les données nécessaires pour sérialiser l’objet cible.

S’applique à

Voir aussi