Standardformatsträngar för datum och tid

Artikel
04/08/2023

En standardsträng för datum- och tidsformat använder ett enda tecken som formatspecificerare för att definiera textrepresentationen av ett DateTime eller ett DateTimeOffset värde. Alla datum- och tidsformatsträngar som innehåller mer än ett tecken, inklusive blanksteg, tolkas som en anpassad datum- och tidsformatsträng. En standardsträng eller en anpassad formatsträng kan användas på två sätt:

Definiera strängen som är resultatet av en formateringsåtgärd.
Definiera textrepresentationen av ett datum- och tidsvärde som kan konverteras till ett DateTime eller-värde DateTimeOffset med en parsningsåtgärd.

Tips

Du kan ladda ned formateringsverktyget, ett .NET-Windows Forms program som gör att du kan använda formatsträngar för numeriska värden eller datum- och tidsvärden och visa resultatsträngen. Källkoden är tillgänglig för C# och Visual Basic.

Anteckning

Några av C#-exemplen i den här artikeln körs i Try.NET infogad kodkörare och lekplats. Välj knappen Kör för att köra ett exempel i ett interaktivt fönster. När du har kört koden kan du ändra den och köra den ändrade koden genom att välja Kör igen. Den ändrade koden körs antingen i det interaktiva fönstret eller, om kompilering misslyckas, visar det interaktiva fönstret alla felmeddelanden för C#-kompilatorn.

Den lokala tidszonen för Try.NET infogad kodkörare och lekplats är Coordinated Universal Time eller UTC. Detta kan påverka beteendet och utdata från exempel som illustrerar typerna DateTime, DateTimeOffsetoch TimeZoneInfo och deras medlemmar.

Tabell med formatspecificerare

I följande tabell beskrivs standardspecificerarna för datum- och tidsformat. Om inget annat anges skapar en viss standardspecificerare för datum- och tidsformat en identisk strängrepresentation oavsett om den används med ett DateTime eller ett DateTimeOffset värde. Mer information om hur du använder standardsträngar för datum- och tidsformat finns i Kontrollpanelen Inställningar och DateTimeFormatInfo-egenskaper.

Formatspecificerare	Beskrivning	Exempel
"d"	Kort datummönster. Mer information:Formatspecificeraren för kort datum ("d").	2009-06-15T13:45:30 -> 2009-06-15 (en-US) 2009-06-15T13:45:30 -> 2009-15-06 (fr-FR) 2009-06-15T13:45:30 -> 2009/06/15 (ja-JP)
"D"	Långt datummönster. Mer information:Formatspecificeraren för långt datum ("D").	2009-06-15T13:45:30 -> Måndag, Juni 15, 2009 (en-US) 2009-06-15T13:45:30 -> понедельник, 15 июня 2009 г. (ru-RU) 2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE)
"f"	Mönster för fullständigt datum/tid (kort tid). Mer information: Formatspecificeraren för fullständig kort tid ("f").	2009-06-15T13:45:30 –> Måndag 15 juni 2009 13:45 (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ (el-GR)
"F"	Mönster för fullständigt datum/tid (lång tid). Mer information: Formatspecificeraren för fullständigt datum ("F").	2009-06-15T13:45:30 –> måndag 15 juni 2009 13:45:30 (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 13:45:30 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μμ (el-GR)
"g"	Allmänt datum-/tidsmönster (kort tid). Mer information: Formatspecificeraren för kort tid ("g") för allmänt datum.	2009-06-15T13:45:30 -> 2009-06-15 13:45 (en-US) 2009-06-15T13:45:30 -> 2009-15-06 13:45 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)
"G"	Allmänt datum-/tidsmönster (lång tid). Mer information: Formatspecificeraren för allmän datum/lång tid ("G").	2009-06-15T13:45:30 -> 2009-06-15 13:30 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45:30 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45:30 (zh-CN)
"M", "m"	Mönster för månad/dag. Mer information: Month ("M", "m") formatspecificerare.	2009-06-15T13:45:30 -> 15 juni (en-US) 2009-06-15T13:45:30 -> 15. juni (da-DK) 2009-06-15T13:45:30 –> 15 Juni (id-ID)
"O", "o"	datum-/tidsmönster för tur och retur. Mer information: Returformatsspecificeraren ("O", "o").	DateTime Värden: 2009-06-15T13:45:30 (DateTimeKind.Local) --> 2009-06-15T13:45:30.0000000-07:00 2009-06-15T13:45:30 (DateTimeKind.Utc) --> 2009-06-15T13:45:30.0000000Z 2009-06-15T13:45:30 (DateTimeKind.Unspecified) --> 2009-06-15T13:45:30.0000000 DateTimeOffset Värden: 2009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.0000000-07:00
"R", "r"	RFC1123-mönster. Mer information: Formatspecificeraren RFC1123 ("R", "r").	DateTimeOffset input: 2009-06-15T13:45:30 -> Mån, 15 jun 2009 20:45:30 GMT DateTime input: 2009-06-15T13:45:30 -> Mån, 15 jun 2009 13:45:30 GMT
"s"	Sorterbart datum-/tidsmönster. Mer information: Den sorterbara formatspecificeraren ("s").	2009-06-15T13:45:30 (DateTimeKind.Local) -> 2009-06-15T13:45:30 2009-06-15T13:45:30 (DateTimeKind.Utc) –> 2009-06-15T13:45:30
"t"	Kort tidsmönster. Mer information: Formatspecificeraren för kort tid ("t").	2009-06-15T13:45:30-> 13:45 (en-US) 2009-06-15T13:45:30 -> 13:45 (hr-HR) 2009-06-15T13:45:30 -> 01:45 م (ar-EG)
"T"	Mönster för lång tid. Mer information: Formatspecificeraren för lång tid ("T").	2009-06-15T13:45:30-> 13:45:30 (en-US) 2009-06-15T13:45:30 -> 13:45:30 (hr-HR) 2009-06-15T13:45:30 -> 01:45:30 م (ar-EG)
"u"	Universellt sorterbart datum/tid-mönster. Mer information: Den universella sorterbara formatspecificeraren ("u").	Med ett DateTime värde: 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z Med ett DateTimeOffset värde: 2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z
"U"	Universellt fullständigt datum/tid-mönster. Mer information: Den universella fullständiga formatspecificeraren ("U").	2009-06-15T13:45:30 -> Måndag 15 juni 2009 20:45:30 (en-US) 2009-06-15T13:45:30 -> den 15 juni 2009 20:45:30 (sv-SE) 2009-06-15T13:45:30 -> Δευτέρα, 15 Ιουνίου 2009 8:45:30 μμ (el-GR)
"Y", "y"	Årsmånadsmönster. Mer information: Formatspecificeraren årsmånad ("Y").	2009-06-15T13:45:30 -> Juni 2009 (en-US) 2009-06-15T13:45:30 -> juni 2009 (da-DK) 2009-06-15T13:45:30 –> Juni 2009 (id-ID)
Alla andra enkla tecken	Okänd specificerare.	Genererar en körning FormatException.

Så här fungerar standardformatsträngar

I en formateringsåtgärd är en standardformatsträng helt enkelt ett alias för en anpassad formatsträng. Fördelen med att använda ett alias för att referera till en anpassad formatsträng är att även om aliaset förblir invariant kan själva den anpassade formatsträngen variera. Detta är viktigt eftersom strängrepresentationerna av datum- och tidsvärden vanligtvis varierar beroende på kultur. Standardformatsträngen "d" anger till exempel att ett datum- och tidsvärde ska visas med ett kort datummönster. För den invarianta kulturen är det här mönstret "MM/dd/åååå". För fr-FR-kulturen är det "dd/MM/åååå". För ja-JP-kulturen är det "yyyy/MM/dd".

Om en standardformatsträng i en formateringsåtgärd mappar till en viss kulturs anpassade formatsträng kan ditt program definiera den specifika kultur vars anpassade formatsträngar används på något av följande sätt:

Du kan använda standardkulturen (eller aktuell). I följande exempel visas ett datum med den aktuella kulturens korta datumformat. I det här fallet är den aktuella kulturen en-US.

// Display using current (en-us) culture's short date format
DateTime thisDate = new DateTime(2008, 3, 15);
Console.WriteLine(thisDate.ToString("d"));           // Displays 3/15/2008

' Display using current (en-us) culture's short date format
Dim thisDate As Date = #03/15/2008#
Console.WriteLine(thisDate.ToString("d"))     ' Displays 3/15/2008

Du kan skicka ett CultureInfo objekt som representerar kulturen vars formatering ska användas till en metod som har en IFormatProvider parameter. I följande exempel visas ett datum med det korta datumformatet för pt-BR-kulturen.

// Display using pt-BR culture's short date format
DateTime thisDate = new DateTime(2008, 3, 15);
CultureInfo culture = new CultureInfo("pt-BR");
Console.WriteLine(thisDate.ToString("d", culture));  // Displays 15/3/2008

' Display using pt-BR culture's short date format
Dim thisDate As Date = #03/15/2008#
Dim culture As New CultureInfo("pt-BR")
Console.WriteLine(thisDate.ToString("d", culture))   ' Displays 15/3/2008

Du kan skicka ett DateTimeFormatInfo objekt som tillhandahåller formateringsinformation till en metod som har en IFormatProvider parameter. I följande exempel visas ett datum med det korta datumformatet från ett DateTimeFormatInfo objekt för hr-HR-kulturen.

// Display using date format information from hr-HR culture
DateTime thisDate = new DateTime(2008, 3, 15);
DateTimeFormatInfo fmt = (new CultureInfo("hr-HR")).DateTimeFormat;
Console.WriteLine(thisDate.ToString("d", fmt));      // Displays 15.3.2008

' Display using date format information from hr-HR culture
Dim thisDate As Date = #03/15/2008#
Dim fmt As DateTimeFormatInfo = (New CultureInfo("hr-HR")).DateTimeFormat
Console.WriteLine(thisDate.ToString("d", fmt))   ' Displays 15.3.2008

Anteckning

Information om hur du anpassar de mönster eller strängar som används för att formatera datum- och tidsvärden finns i klassavsnittet NumberFormatInfo .

I vissa fall fungerar standardformatsträngen som en praktisk förkortning för en längre anpassad formatsträng som är invariant. Fyra standardformatsträngar tillhör den här kategorin: "O" (eller "o"), "R" (eller "r"), "s" och "u". Dessa strängar motsvarar anpassade formatsträngar som definieras av den invarianta kulturen. De skapar strängrepresentationer av datum- och tidsvärden som är avsedda att vara identiska mellan kulturer. Följande tabell innehåller information om dessa fyra standardsträngar för datum- och tidsformat.

Standardformatsträng	Definieras av egenskapen DateTimeFormatInfo.InvariantInfo	Anpassad formatsträng
"O" eller "o"	Ingen	yyyy'-'MM'-'dd'T'HH':'mm'ss'. fffffffK
"R" eller "r"	RFC1123Pattern	ddd, dd MMM yyyy HH':'mm':ss 'GMT'
"s"	SortableDateTimePattern	yyyy'-'MM'-'dd'T'HH':'mm':'ss
"u"	UniversalSortableDateTimePattern	yyyy'-'MM'-'dd HH':'mm':'ss'Z'

Standardformatsträngar kan också användas för att parsa åtgärder med DateTime.ParseExact metoderna eller DateTimeOffset.ParseExact , vilket kräver att en indatasträng exakt överensstämmer med ett visst mönster för att parsningsåtgärden ska lyckas. Många standardformatsträngar mappas till flera anpassade formatsträngar, så ett datum- och tidsvärde kan representeras i olika format och parsningsåtgärden kommer fortfarande att lyckas. Du kan fastställa den anpassade formatsträngen eller strängarna som motsvarar en standardformatsträng genom att anropa DateTimeFormatInfo.GetAllDateTimePatterns(Char) metoden. I följande exempel visas de anpassade formatsträngar som mappar till standardformatsträngen "d" (kort datummönster).

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      Console.WriteLine("'d' standard format string:");
      foreach (var customString in DateTimeFormatInfo.CurrentInfo.GetAllDateTimePatterns('d'))
          Console.WriteLine("   {0}", customString);
   }
}
// The example displays the following output:
//       'd' standard format string:
//          M/d/yyyy
//          M/d/yy
//          MM/dd/yy
//          MM/dd/yyyy
//          yy/MM/dd
//          yyyy-MM-dd
//          dd-MMM-yy

Imports System.Globalization

Module Example
    Public Sub Main()
        Console.WriteLine("'d' standard format string:")
        For Each customString In DateTimeFormatInfo.CurrentInfo.GetAllDateTimePatterns("d"c)
            Console.WriteLine("   {0}", customString)
        Next
    End Sub
End Module
' The example displays the following output:
'    'd' standard format string:
'       M/d/yyyy
'       M/d/yy
'       MM/dd/yy
'       MM/dd/yyyy
'       yy/MM/dd
'       yyyy-MM-dd
'       dd-MMM-yy

I följande avsnitt beskrivs standardformatsspecificerare för DateTime och DateTimeOffset värden.

Datumformat

Den här gruppen innehåller följande format:

Formatspecificeraren för kort datum ("d")
Formatspecificeraren för långt datum ("D")

Formatspecificeraren för kort datum ("d")

Standardformatsspecificeraren d representerar en anpassad datum- och tidsformatsträng som definieras av en specifik kulturs DateTimeFormatInfo.ShortDatePattern egenskap. Till exempel är den anpassade formatsträngen ShortDatePattern som returneras av egenskapen för den invarianta kulturen "MM/dd/åååå".

I följande tabell visas de DateTimeFormatInfo objektegenskaper som styr formateringen av den returnerade strängen.

Egenskap	Beskrivning
ShortDatePattern	Definierar det övergripande formatet för resultatsträngen.
DateSeparator	Definierar strängen som separerar komponenterna år, månad och dag för ett datum.

I följande exempel används formatspecificeraren "d" för att visa ett datum- och tidsvärde.

DateTime date1 = new DateTime(2008,4, 10);
Console.WriteLine(date1.ToString("d", DateTimeFormatInfo.InvariantInfo));
// Displays 04/10/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("en-US")));
// Displays 4/10/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("en-NZ")));
// Displays 10/04/2008
Console.WriteLine(date1.ToString("d",
                  CultureInfo.CreateSpecificCulture("de-DE")));
// Displays 10.04.2008

Dim date1 As Date = #4/10/2008#
Console.WriteLine(date1.ToString("d", DateTimeFormatInfo.InvariantInfo))
' Displays 04/10/2008
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("en-US")))
' Displays 4/10/2008                       
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("en-NZ")))
' Displays 10/04/2008                       
Console.WriteLine(date1.ToString("d", _
                  CultureInfo.CreateSpecificCulture("de-DE")))
' Displays 10.04.2008

Egenskap	Beskrivning
LongDatePattern	Definierar det övergripande formatet för resultatsträngen.
DayNames	Definierar de lokaliserade dagnamnen som kan visas i resultatsträngen.
MonthNames	Definierar de lokaliserade månadsnamnen som kan visas i resultatsträngen.

Egenskap	Beskrivning
LongDatePattern	Definierar formatet för datumkomponenten i resultatsträngen.
ShortTimePattern	Definierar formatet för tidskomponenten i resultatsträngen.
DayNames	Definierar de lokaliserade dagnamnen som kan visas i resultatsträngen.
MonthNames	Definierar de lokaliserade månadsnamnen som kan visas i resultatsträngen.
TimeSeparator	Definierar strängen som separerar komponenterna timme, minut och sekund i en tid.
AMDesignator	Definierar strängen som anger tider från midnatt till före 12:00 i en 12-timmarsklocka.
PMDesignator	Definierar strängen som anger tider från 12:00 till före midnatt i en 12-timmarsklocka.

Egenskap	Beskrivning
FullDateTimePattern	Definierar det övergripande formatet för resultatsträngen.
DayNames	Definierar de lokaliserade dagnamnen som kan visas i resultatsträngen.
MonthNames	Definierar de lokaliserade månadsnamnen som kan visas i resultatsträngen.
TimeSeparator	Definierar strängen som separerar komponenterna timme, minut och sekund i en tid.
AMDesignator	Definierar strängen som anger tider från midnatt till före 12:00 i en 12-timmarsklocka.
PMDesignator	Definierar strängen som anger tider från 12:00 till före midnatt i en 12-timmarsklocka.

Egenskap	Beskrivning
ShortDatePattern	Definierar formatet för datumkomponenten i resultatsträngen.
LongTimePattern	Definierar formatet för tidskomponenten i resultatsträngen.
DateSeparator	Definierar strängen som separerar komponenterna för år, månad och dag för ett datum.
TimeSeparator	Definierar strängen som separerar komponenterna timme, minut och sekund i en tid.
AMDesignator	Definierar strängen som anger tider från midnatt till före 12:00 i en 12-timmarsklocka.
PMDesignator	Definierar strängen som anger tider från 12:00 till före midnatt i en 12-timmarsklocka.

Egenskap	Beskrivning
RFC1123Pattern	Definierar formatet för resultatsträngen.
AbbreviatedDayNames	Definierar de förkortade dagnamnen som kan visas i resultatsträngen.
AbbreviatedMonthNames	Definierar de förkortade månadsnamnen som kan visas i resultatsträngen.

Egenskap	Beskrivning
MonthDayPattern	Definierar det övergripande formatet för resultatsträngen.
MonthNames	Definierar de lokaliserade månadsnamnen som kan visas i resultatsträngen.

Egenskap	Beskrivning
YearMonthPattern	Definierar det övergripande formatet för resultatsträngen.
MonthNames	Definierar de lokaliserade månadsnamnen som kan visas i resultatsträngen.

Standardformatsträngar för datum och tid

Tabell med formatspecificerare

Så här fungerar standardformatsträngar

Datumformat

Formatspecificeraren för kort datum ("d")

Formatspecificeraren för långt datum ("D")

Datum- och tidsformat

Formatspecificeraren för fullständigt datum ("f")

Formatspecificeraren för fullständigt datum ("F")

Specificeraren för kort tid för allmänt datum ("g")

Formatspecificeraren för allmän datum/lång tid ("G")

Formatspecificeraren rundresa ("O", "o")

RFC1123-formatspecificeraren ("R", "r")

Den sorterbara formatspecificeraren ("s")

Den universella sorterbara formatspecificeraren ("u")

Den universella fullständiga formatspecificeraren ("U")

Tidsformat

Formatspecificeraren för kort tid ("t")

Formatspecificeraren för lång tid ("T")

Partiella datumformat

Formatspecificeraren för månad ("M", "m")

Formatspecificeraren årsmånad ("Y", "y")

Kontrollpanelen inställningar

DateTimeFormatInfo-egenskaper

Se även

Feedback

Ytterligare resurser