DateTimeFormatInfo Classe

Définition

Fournit des informations spécifiques à la 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). 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)

Implémentations d’interfaces explicites

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

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

S’applique à

Voir aussi