DateTimeOffset.ToString Méthode

Référence

Définition

Espace de noms:: System

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Convertit la valeur de l'objet DateTimeOffset actif en sa représentation équivalente sous forme de chaîne.

Surcharges

ToString()	Convertit la valeur de l'objet DateTimeOffset actif en sa représentation équivalente sous forme de chaîne.
ToString(IFormatProvider)	Convertit la valeur de l'objet DateTimeOffset en cours en représentation sous forme de chaîne équivalente à l'aide des informations de format propres à la culture spécifiées.
ToString(String)	Convertit la valeur de l'objet DateTimeOffset actuel en sa représentation sous forme de chaîne équivalente en utilisant le format spécifié.
ToString(String, IFormatProvider)	Convertit la valeur de l'objet DateTimeOffset actuel en sa représentation sous forme de chaîne équivalente à l'aide du format et des informations de format spécifiques à la culture spécifiés.

ToString()

Convertit la valeur de l'objet DateTimeOffset actif en sa représentation équivalente sous forme de chaîne.

public:
 override System::String ^ ToString();

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Retours

String

Représentation sous forme de chaîne d'un objet DateTimeOffsetqui inclut l'offset ajouté à la fin de la chaîne.

Exceptions

ArgumentOutOfRangeException

La date et l’heure sont en dehors de la plage de dates prise en charge par le calendrier utilisé par la culture actuelle.

Exemples

L’exemple suivant illustre les appels à la méthode et affiche sa sortie sur un système dont la ToString() culture actuelle est en-us.

DateTimeOffset thisDate;

// Show output for UTC time
thisDate = DateTimeOffset.UtcNow;
Console.WriteLine(thisDate.ToString());  // Displays 3/28/2007 7:13:50 PM +00:00

// Show output for local time
thisDate = DateTimeOffset.Now;
Console.WriteLine(thisDate.ToString());  // Displays 3/28/2007 12:13:50 PM -07:00

// Show output for arbitrary time offset
thisDate = thisDate.ToOffset(new TimeSpan(-5, 0, 0));
Console.WriteLine(thisDate.ToString());  // Displays 3/28/2007 2:13:50 PM -05:00

// Show output for UTC time
let thisDate = DateTimeOffset.UtcNow
printfn $"{thisDate.ToString()}"  // Displays 3/28/2007 7:13:50 PM +00:00

// Show output for local time
let thisDate = DateTimeOffset.Now
printfn $"{thisDate.ToString()}"  // Displays 3/28/2007 12:13:50 PM -07:00

// Show output for arbitrary time offset
let thisDate = thisDate.ToOffset(TimeSpan(-5, 0, 0))
printfn $"{thisDate.ToString()}"  // Displays 3/28/2007 2:13:50 PM -05:00

Dim thisDate As DateTimeOffset

' Show output for UTC time
thisDate = DateTimeOffset.UtcNow
Console.WriteLine(thisDate.ToString())  ' Displays 3/28/2007 7:13:50 PM +00:00

' Show output for local time 
thisDate = DateTimeOffset.Now
Console.WriteLine(thisDate.ToString())  ' Displays 3/28/2007 12:13:50 PM -07:00

' Show output for arbitrary time offset
thisDate = thisDate.ToOffset(new TimeSpan(-5, 0, 0))
Console.WriteLine(thisDate.ToString())  ' Displays 3/28/2007 2:13:50 PM -05:00

Remarques

La valeur de retour de cette méthode est identique à celle de la DateTime.ToString() méthode, sauf qu’elle inclut un espace suivi du décalage ajouté à la fin de la chaîne. En d’autres termes, il met en forme la sortie à l’aide du modèle de date courte, du modèle de temps long et de la zzz chaîne de format personnalisée, avec chaque élément séparé de l’élément précédent par un espace. Par exemple, si DateTime.ToString() elle retourne une valeur de 1/12/2008 15:15:50, ToString() retourne une valeur de 1/12/2008 6:50:50 -08:00 pour une heure qui est de huit heures derrière l’heure UTC (Temps universel coordonné).

Cette méthode utilise des informations de mise en forme dérivées de la culture actuelle. Pour plus d'informations, consultez CurrentCulture. D’autres surcharges de la ToString méthode vous permettent de spécifier la culture dont la mise en forme doit être utilisée et de définir le modèle de sortie de la DateTimeOffset valeur.

Notes pour les appelants

La ToString() méthode retourne la représentation sous forme de chaîne de la date et de l’heure dans le calendrier utilisé par la culture actuelle. Si la valeur de l’instance actuelle est antérieure ou ultérieure MaxSupportedDateTimeà celle-ciDateTimeOffset, la méthode lève un ArgumentOutOfRangeException.MinSupportedDateTime L'exemple suivant illustre cette situation. Il tente de mettre en forme une date qui est en dehors de la plage de la HijriCalendar classe lorsque la culture actuelle est arabe (Syrie).

::code language="csharp » source="~/snippets/csharp/System/DateTimeOffset/ToString/datetimeoffset.tostring.argumentoutofrangeexception2.cs » id="Snippet2 »::: :::code language="fsharp » source="~/snippets/fsharp/VS_Snippets_CLR_System/system.datetimeoffset.tostring.argumentoutofrangeexception/fs/datetimeoffset.tostring.argumentoutofrangeexception2.fs » id="Snippet2 »::: :::code language="vb » source="~/snippets/visualbasic/VS_Snippets_CLR_System/ system.datetimeoffset.tostring.argumentoutofrangeexception/vb/datetimeoffset.tostring.argumentoutofrangeexception2.vb » id="Snippet2 »:::

S’applique à

ToString(IFormatProvider)

Convertit la valeur de l'objet DateTimeOffset en cours en représentation sous forme de chaîne équivalente à l'aide des informations de format propres à la culture spécifiées.

public:
 System::String ^ ToString(IFormatProvider ^ formatProvider);

public string ToString (IFormatProvider formatProvider);

public string ToString (IFormatProvider? formatProvider);

override this.ToString : IFormatProvider -> string

Public Function ToString (formatProvider As IFormatProvider) As String

Paramètres

formatProvider: IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture.

Retours

String

Représentation sous forme de chaîne de la valeur de l’objet DateTimeOffset actuel, telle que spécifiée par formatProvider.

Exceptions

ArgumentOutOfRangeException

La date et l’heure sont en dehors de la plage de dates prise en charge par le calendrier utilisé par formatProvider.

Exemples

L’exemple suivant affiche un objet utilisant CultureInfo des DateTimeOffset objets qui représentent la culture indifférente, ainsi que quatre autres cultures.

CultureInfo[] cultures = new CultureInfo[] {CultureInfo.InvariantCulture,
                                           new CultureInfo("en-us"),
                                           new CultureInfo("fr-fr"),
                                           new CultureInfo("de-DE"),
                                           new CultureInfo("es-ES")};

DateTimeOffset thisDate = new DateTimeOffset(2007, 5, 1, 9, 0, 0,
                                             TimeSpan.Zero);

foreach (CultureInfo culture in cultures)
{
   string cultureName;
   if (string.IsNullOrEmpty(culture.Name))
      cultureName = culture.NativeName;
   else
      cultureName = culture.Name;

   Console.WriteLine("In {0}, {1}",
                     cultureName, thisDate.ToString(culture));
}
// The example produces the following output:
//    In Invariant Language (Invariant Country), 05/01/2007 09:00:00 +00:00
//    In en-US, 5/1/2007 9:00:00 AM +00:00
//    In fr-FR, 01/05/2007 09:00:00 +00:00
//    In de-DE, 01.05.2007 09:00:00 +00:00
//    In es-ES, 01/05/2007 9:00:00 +00:00

let cultures = 
    [| CultureInfo.InvariantCulture
       CultureInfo "en-us"
       CultureInfo "fr-fr"
       CultureInfo "de-DE"
       CultureInfo "es-ES" |]

let thisDate = DateTimeOffset(2007, 5, 1, 9, 0, 0, TimeSpan.Zero)

for culture in cultures do
    let cultureName = 
        if String.IsNullOrEmpty culture.Name then
            culture.NativeName
        else
            culture.Name
    printfn $"In {cultureName}, {thisDate.ToString culture}"

// The example produces the following output:
//    In Invariant Language (Invariant Country), 05/01/2007 09:00:00 +00:00
//    In en-US, 5/1/2007 9:00:00 AM +00:00
//    In fr-FR, 01/05/2007 09:00:00 +00:00
//    In de-DE, 01.05.2007 09:00:00 +00:00
//    In es-ES, 01/05/2007 9:00:00 +00:00

     Dim cultures() As CultureInfo = {CultureInfo.InvariantCulture, _
                                      New CultureInfo("en-us"), _
                                      New CultureInfo("fr-fr"), _
                                      New CultureInfo("de-DE"), _
                                      New CultureInfo("es-ES")}

     Dim thisDate As New DateTimeOffset(#5/1/2007 9:00AM#, TimeSpan.Zero)                                            

     For Each culture As CultureInfo In cultures
        Dim cultureName As String 
        If String.IsNullOrEmpty(culture.Name) Then
           cultureName = culture.NativeName
        Else
           cultureName = culture.Name
        End If
        Console.WriteLine("In {0}, {1}", _
                          cultureName, thisDate.ToString(culture))
     Next                                            
     ' The example produces the following output:
     '    In Invariant Language (Invariant Country), 05/01/2007 09:00:00 +00:00
     '    In en-US, 5/1/2007 9:00:00 AM +00:00
     '    In fr-FR, 01/05/2007 09:00:00 +00:00
     '    In de-DE, 01.05.2007 09:00:00 +00:00
     '    In es-ES, 01/05/2007 9:00:00 +00:00

Remarques

La valeur de retour de cette méthode est identique à celle de sa surcharge équivalente de la DateTime.ToString méthode, sauf qu’elle inclut un espace suivi du décalage ajouté à la fin de la chaîne. En d’autres termes, il met en forme la sortie à l’aide du modèle de date courte, du modèle de temps long et de la zzz chaîne de format personnalisée, avec chaque élément séparé de l’élément précédent par un espace.

Le format de ces trois éléments est défini par le formatProvider paramètre. Le formatProvider paramètre peut être l’un des éléments suivants :

Objet CultureInfo qui représente la culture dont les conventions de mise en forme sont appliquées à la chaîne retournée. L’objet DateTimeFormatInfo retourné par la CultureInfo.DateTimeFormat propriété définit la mise en forme de la chaîne retournée.
Objet DateTimeFormatInfo qui définit le format des données de date et d’heure.

Si formatProvider c’est le cas null, l’objet DateTimeFormatInfo associé à la culture actuelle est utilisé (voir CurrentCulture).

Notes pour les appelants

La ToString(IFormatProvider) méthode retourne la représentation sous forme de chaîne de la date et de l’heure dans le calendrier utilisé par la culture représentée par le formatProvider paramètre. Son calendrier est défini par la Calendar propriété. Si la valeur de l’instance actuelle est antérieure ou ultérieure MaxSupportedDateTimeà celle-ciDateTimeOffset, la méthode lève un ArgumentOutOfRangeException.MinSupportedDateTime L'exemple suivant illustre cette situation. Il tente de mettre en forme une date qui se trouve en dehors de la plage de la JapaneseCalendar classe.

::code language="csharp » source="~/snippets/csharp/System/DateTimeOffset/ToString/datetimeoffset.tostring.argumentoutofrangeexception1.cs » interactive="try-dotnet » id="Snippet1 »::: :::code language="fsharp » source="~/snippets/fsharp/VS_Snippets_CLR_System/system.datetimeoffset.tostring.argumentoutofrangeexception/fs/datetimeoffset.tostring.argumentoutofrangeexception1.fs » id="Snippet1 »::: :::code language="vb » source="~/snippets/visualbasic/VS_Snippets_CLR_ System/system.datetimeoffset.tostring.argumentoutofrangeexception/vb/datetimeoffset.tostring.argumentoutofrangeexception1.vb » id="Snippet1 »:::

S’applique à

ToString(String)

Convertit la valeur de l'objet DateTimeOffset actuel en sa représentation sous forme de chaîne équivalente en utilisant le format spécifié.

public:
 System::String ^ ToString(System::String ^ format);

public string ToString (string format);

public string ToString (string? format);

override this.ToString : string -> string

Public Function ToString (format As String) As String

Paramètres

format: String

Chaîne de format.

Retours

String

Représentation sous forme de chaîne de la valeur de l’objet DateTimeOffset actuel, telle que spécifiée par format.

Exceptions

FormatException

La longueur de format est égale à un, et ce n’est pas l’un des caractères spécificateurs de format standard définis pour DateTimeFormatInfo.

ou -

format ne contient pas un modèle de format personnalisé valide.

ArgumentOutOfRangeException

La date et l’heure sont en dehors de la plage de dates prise en charge par le calendrier utilisé par la culture actuelle.

Exemples

L’exemple suivant affiche un DateTimeOffset objet dans la console à l’aide de chacun des spécificateurs de format de date et d’heure standard. La sortie est mise en forme à l’aide de la culture en-us.

DateTimeOffset outputDate = new DateTimeOffset(2007, 10, 31, 21, 0, 0,
                                     new TimeSpan(-8, 0, 0));
string specifier;

// Output date using each standard date/time format specifier
specifier = "d";
// Displays   d: 10/31/2007
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));

specifier = "D";
// Displays   D: Wednesday, October 31, 2007
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));

specifier = "t";
// Displays   t: 9:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));

specifier = "T";
// Displays   T: 9:00:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));

specifier = "f";
// Displays   f: Wednesday, October 31, 2007 9:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));

specifier = "F";
// Displays   F: Wednesday, October 31, 2007 9:00:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));

specifier = "g";
// Displays   g: 10/31/2007 9:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));

specifier = "G";
// Displays   G: 10/31/2007 9:00:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));

specifier = "M";           // 'm' is identical
// Displays   M: October 31
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));

specifier = "R";           // 'r' is identical
// Displays   R: Thu, 01 Nov 2007 05:00:00 GMT
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));

specifier = "s";
// Displays   s: 2007-10-31T21:00:00
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));

specifier = "u";
// Displays   u: 2007-11-01 05:00:00Z
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));

// Specifier is not supported
specifier = "U";
try
{
   Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));
}
catch (FormatException)
{
   Console.WriteLine("{0}: Not supported.", specifier);
}

specifier = "Y";         // 'y' is identical
// Displays   Y: October, 2007
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier));

let outputDate = DateTimeOffset(2007, 10, 31, 21, 0, 0, TimeSpan(-8, 0, 0))

// Output date using each standard date/time format specifier
let specifier = "d"
// Displays   d: 10/31/2007
printfn $"{specifier}: {outputDate.ToString specifier}"

let specifier = "D"
// Displays   D: Wednesday, October 31, 2007
printfn $"{specifier}: {outputDate.ToString specifier}"

let specifier = "t"
// Displays   t: 9:00 PM
printfn $"{specifier}: {outputDate.ToString specifier}"

let specifier = "T"
// Displays   T: 9:00:00 PM
printfn $"{specifier}: {outputDate.ToString specifier}"

let specifier = "f"
// Displays   f: Wednesday, October 31, 2007 9:00 PM
printfn $"{specifier}: {outputDate.ToString specifier}"

let specifier = "F"
// Displays   F: Wednesday, October 31, 2007 9:00:00 PM
printfn $"{specifier}: {outputDate.ToString specifier}"

let specifier = "g"
// Displays   g: 10/31/2007 9:00 PM
printfn $"{specifier}: {outputDate.ToString specifier}"

let specifier = "G"
// Displays   G: 10/31/2007 9:00:00 PM
printfn $"{specifier}: {outputDate.ToString specifier}"

let specifier = "M"           // 'm' is identical
// Displays   M: October 31
printfn $"{specifier}: {outputDate.ToString specifier}"

let specifier = "R"           // 'r' is identical
// Displays   R: Thu, 01 Nov 2007 05:00:00 GMT
printfn $"{specifier}: {outputDate.ToString specifier}"

let specifier = "s"
// Displays   s: 2007-10-31T21:00:00
printfn $"{specifier}: {outputDate.ToString specifier}"

let specifier = "u"
// Displays   u: 2007-11-01 05:00:00Z
printfn $"{specifier}: {outputDate.ToString specifier}"

// Specifier is not supported
let specifier = "U"
try
    printfn $"{specifier}: {outputDate.ToString specifier}"
with :? FormatException ->
    printfn $"{specifier}: Not supported."

let specifier = "Y"         // 'y' is identical
// Displays   Y: October, 2007
printfn $"{specifier}: {outputDate.ToString specifier}"

Dim outputDate As New DateTimeOffset(#10/31/2007 9:00PM#, _
                                     New TimeSpan(-8, 0, 0))
Dim specifier As String 
      
' Output date using each standard date/time format specifier
specifier = "d"
' Displays   d: 10/31/2007
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "D"
' Displays   D: Wednesday, October 31, 2007
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "t"
' Displays   t: 9:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "T"
' Displays   T: 9:00:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "f"
' Displays   f: Wednesday, October 31, 2007 9:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "F"
' Displays   F: Wednesday, October 31, 2007 9:00:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "g"
' Displays   g: 10/31/2007 9:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "G"
' Displays   G: 10/31/2007 9:00:00 PM
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "M"           ' 'm' is identical
' Displays   M: October 31
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "R"           ' 'r' is identical
' Displays   R: Thu, 01 Nov 2007 05:00:00 GMT
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "s"
' Displays   s: 2007-10-31T21:00:00
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

specifier = "u"
' Displays   u: 2007-11-01 05:00:00Z
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 

' Specifier is not supported
specifier = "U"
Try
   Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier)) 
Catch e As FormatException
   Console.WriteLine("{0}: Not supported.", specifier)   
End Try

specifier = "Y"         ' 'y' is identical
' Displays   Y: October, 2007
Console.WriteLine("{0}: {1}", specifier, outputDate.ToString(specifier))

Remarques

Le format paramètre doit contenir un caractère spécificateur de format unique (voir Chaînes de format de date et d’heure standard) ou un modèle de format personnalisé (voir Chaînes de format de date et d’heure personnalisés) qui définit le format de la chaîne retournée. S’il s’agit format d’une chaîne null ou vide ( » « ), la DateTimeOffset valeur est générée à l’aide du format par défaut.

Le tableau suivant montre l’opération exacte de certains spécificateurs de format lorsqu’ils sont utilisés avec DateTimeOffset, ce qui diffère de leur comportement lorsqu’ils sont utilisés avec DateTime.

Spécificateur de format existant	Nouveau comportement
"K"	Conçu pour aller-retour une date et une heure. Avec DateTimeOffset, mappe à « zzz » (le décalage est toujours affiché avec des heures et des minutes). Notez que « K » est un spécificateur de format personnalisé ; il ne peut pas apparaître en tant que caractère unique dans `format`.
"U"	Non pris en charge.
« r »	Convertit l’objet DateTimeOffset en temps universel coordonné (UTC) et le génère à l’aide de la chaîne `ddd, dd MMM yyyy HH:mm:ss GMT`de format personnalisée.
"u"	Convertit l’objet DateTimeOffset en UTC et le génère à l’aide du format `yyyy-MM-dd HH:mm:ssZ`.

Les spécificateurs de format de date et d’heure standard restants se comportent de la ToString(String) même façon qu’avec la ToString méthode.

Cette méthode utilise des informations de mise en forme dérivées de la culture actuelle. Pour plus d'informations, consultez CurrentCulture.

Notes pour les appelants

La ToString(String) méthode retourne la représentation sous forme de chaîne de la date et de l’heure dans le calendrier utilisé par la culture actuelle. Si la valeur de l’instance actuelle est antérieure ou ultérieure MaxSupportedDateTimeà celle-ciDateTimeOffset, la méthode lève un ArgumentOutOfRangeException.MinSupportedDateTime L'exemple suivant illustre cette situation. Il tente de mettre en forme une date qui est en dehors de la plage de la HebrewCalendar classe lorsque la culture actuelle est hébreu (Israël).

::code language="csharp » source="~/snippets/csharp/System/DateTimeOffset/ToString/datetimeoffset.tostring.argumentoutofrangeexception3.cs » interactive="try-dotnet » id="Snippet3 »::: :::code language="fsharp » source="~/snippets/fsharp/VS_Snippets_CLR_System/system.datetimeoffset.tostring.argumentoutofrangeexception/fs/datetimeoffset.tostring.argumentoutofrangeexception3.fs » id="Snippet3 »::: ::code language="vb » source="~/snippets/visualbasic/VS_Snippets_CLR_ System/system.datetimeoffset.tostring.argumentoutofrangeexception/vb/datetimeoffset.tostring.argumentoutofrangeexception3.vb » id="Snippet3 »:::

Voir aussi

S’applique à

ToString(String, IFormatProvider)

Convertit la valeur de l'objet DateTimeOffset actuel en sa représentation sous forme de chaîne équivalente à l'aide du format et des informations de format spécifiques à la culture spécifiés.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ formatProvider);

public string ToString (string format, IFormatProvider formatProvider);

public string ToString (string? format, IFormatProvider? formatProvider);

override this.ToString : string * IFormatProvider -> string

Public Function ToString (format As String, formatProvider As IFormatProvider) As String

Paramètres

format: String

Chaîne de format.

formatProvider: IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture.

Retours

String

Représentation sous forme de chaîne de la valeur de l’objet DateTimeOffset actif, tel que spécifié par format et provider.

Implémente

ToString(String, IFormatProvider)

Exceptions

FormatException

La longueur de format est égale à un, et ce n’est pas l’un des caractères spécificateurs de format standard définis pour DateTimeFormatInfo.

ou -

format ne contient pas un modèle de format personnalisé valide.

ArgumentOutOfRangeException

La date et l’heure sont en dehors de la plage de dates prise en charge par le calendrier utilisé par formatProvider.

Exemples

L’exemple suivant utilise la ToString(String, IFormatProvider) méthode pour afficher un objet à l’aide d’une DateTimeOffset chaîne de format personnalisée pour plusieurs cultures différentes.

DateTimeOffset outputDate = new DateTimeOffset(2007, 11, 1, 9, 0, 0,
                                     new TimeSpan(-7, 0, 0));
string format = "dddd, MMM dd yyyy HH:mm:ss zzz";

// Output date and time using custom format specification
Console.WriteLine(outputDate.ToString(format, null as DateTimeFormatInfo));
Console.WriteLine(outputDate.ToString(format, CultureInfo.InvariantCulture));
Console.WriteLine(outputDate.ToString(format,
                                      new CultureInfo("fr-FR")));
Console.WriteLine(outputDate.ToString(format,
                                      new CultureInfo("es-ES")));
// The example displays the following output to the console:
//    Thursday, Nov 01 2007 09:00:00 -07:00
//    Thursday, Nov 01 2007 09:00:00 -07:00
//    jeudi, nov. 01 2007 09:00:00 -07:00
//    jueves, nov 01 2007 09:00:00 -07:00

let outputDate = DateTimeOffset(2007, 11, 1, 9, 0, 0, TimeSpan(-7, 0, 0))
let format = "dddd, MMM dd yyyy HH:mm:ss zzz"

// Output date and time using custom format specification
printfn $"{outputDate.ToString(format, null)}"
printfn $"{outputDate.ToString(format, CultureInfo.InvariantCulture)}"
printfn $"""{outputDate.ToString(format, CultureInfo "fr-FR")}"""
printfn $"""{outputDate.ToString(format, CultureInfo "es-ES")}"""

// The example displays the following output to the console:
//    Thursday, Nov 01 2007 09:00:00 -07:00
//    Thursday, Nov 01 2007 09:00:00 -07:00
//    jeudi, nov. 01 2007 09:00:00 -07:00
//    jueves, nov 01 2007 09:00:00 -07:00

Dim outputDate As New DateTimeOffset(#11/1/2007 9:00AM#, _
                                     New TimeSpan(-7, 0, 0)) 
Dim format As String = "dddd, MMM dd yyyy HH:mm:ss zzz"

' Output date and time using custom format specification
Console.WriteLine(outputDate.ToString(format, Nothing))
Console.WriteLine(outputDate.ToString(format, CultureInfo.InvariantCulture))
Console.WriteLine(outputDate.ToString(format, _
                                      New CultureInfo("fr-FR")))
Console.WriteLine(outputDate.ToString(format, _
                                      New CultureInfo("es-ES")))
' The example displays the following output to the console:
'    Thursday, Nov 01 2007 09:00:00 -07:00
'    Thursday, Nov 01 2007 09:00:00 -07:00
'    jeudi, nov. 01 2007 09:00:00 -07:00
'    jueves, nov 01 2007 09:00:00 -07:00

Remarques

Le format paramètre doit contenir un caractère spécificateur de format unique (voir Chaînes de format de date et d’heure standard) ou un modèle de format personnalisé (voir Chaînes de format de date et d’heure personnalisées). S’il format s’agit d’une chaîne null ou vide (« »), l’objet DateTimeOffset est généré au format par défaut.

Spécificateur de format existant	Nouveau comportement
"K"	Conçu pour aller-retour une date et une heure. Avec DateTimeOffset, mappe à « zzz » (le décalage est toujours affiché avec des heures et des minutes). Notez que « K » est un spécificateur de format personnalisé ; il ne peut pas apparaître en tant que caractère unique dans `format`.
"U"	Non pris en charge.
« r »	Convertit l’objet DateTimeOffset en temps universel coordonné (UTC) et le génère à l’aide de la chaîne `ddd, dd MMM yyyy HH:mm:ss GMT`de format personnalisée.
"u"	Convertit la DateTimeOffset valeur en UTC et la génère à l’aide du format `yyyy-MM-dd HH:mm:ssZ`.

Les spécificateurs de format de date et d’heure standard restants se comportent de la ToString(String) même façon qu’avec la ToString méthode.

Le modèle qui correspond aux spécificateurs de format standard, ainsi que les symboles et les noms des composants de date et d’heure, est défini par le formatProvider paramètre. Le formatProvider paramètre peut être l’un des éléments suivants :

Objet CultureInfo qui représente la culture dont la mise en forme est utilisée dans input. L’objet DateTimeFormatInfo retourné par la CultureInfo.DateTimeFormat propriété définit la mise en forme utilisée dans input.
Objet DateTimeFormatInfo qui définit le format des données de date et d’heure.

Si formatProvider c’est le cas null, l’objet DateTimeFormatInfo associé à la culture actuelle est utilisé (voir CurrentCulture).

Notes pour les appelants

La ToString(String, IFormatProvider) méthode retourne la représentation sous forme de chaîne de la date et de l’heure dans le calendrier utilisé par le formatProvider paramètre. Son calendrier est défini par la Calendar propriété. Si la valeur de l’instance actuelle est antérieure ou ultérieure MaxSupportedDateTimeà celle-ciDateTimeOffset, la méthode lève un ArgumentOutOfRangeException.MinSupportedDateTime L'exemple suivant illustre cette situation. Il tente de mettre en forme une date qui se trouve en dehors de la plage de la UmAlQuraCalendar classe.

::code language="csharp » source="~/snippets/csharp/System/DateTimeOffset/ToString/datetimeoffset.tostring.argumentoutofrangeexception4.cs » id="Snippet4 »::: :::code language="fsharp » source="~/snippets/fsharp/VS_Snippets_CLR_System/system.datetimeoffset.tostring.argumentoutofrangeexception/fs/datetimeoffset.tostring.argumentoutofrangeexception4.fs » id="Snippet4 »::: :::code language="vb » source="~/snippets/visualbasic/VS_Snippets_CLR_System/ system.datetimeoffset.tostring.argumentoutofrangeexception/vb/datetimeoffset.tostring.argumentoutofrangeexception4.vb » id="Snippet4 »:::

Voir aussi

S’applique à

DateTimeOffset.ToString Méthode

Cette page est-elle utile ?

Définition

Surcharges

ToString()

Retours

Exceptions

Exemples

Remarques

Notes pour les appelants

S’applique à

ToString(IFormatProvider)

Paramètres

Retours

Exceptions

Exemples

Remarques

Notes pour les appelants

S’applique à

ToString(String)

Paramètres

Retours

Exceptions

Exemples

Remarques

Notes pour les appelants

Voir aussi

S’applique à

ToString(String, IFormatProvider)

Paramètres

Retours

Implémente

Exceptions

Exemples

Remarques

Notes pour les appelants

Voir aussi

S’applique à

Ressources supplémentaires