Standardformatsträngar för datum och tid

Artikel
03/22/2025

En standardsträng för datum- och tidsformat använder ett enda tecken som formatspecificerare för att definiera textrepresentationen av en 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 standard- eller anpassad formatsträng kan användas på två sätt:

Så här definierar du 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 DateTimeOffset värde 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.

Anmärkning

Några av C#-exemplen i den här artikeln körs i Try.NET infogad kodlöpare 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 den Try.NET infogade kodlöparen och lekplatsen är Coordinated Universal Time eller UTC. Detta kan påverka beteendet och utdata från exempel som illustrerar DateTime, DateTimeOffsetoch TimeZoneInfo typer och deras medlemmar.

Tabell med formatspecificerare

I följande tabell beskrivs standardformatsspecificerarna för datum och tid. Om inget annat anges skapar en viss standardformatsspecificerare en identisk strängrepresentation oavsett om den används med en DateTime eller ett DateTimeOffset värde. Mer information om hur du använder standardformatsträngar finns i Inställningar för kontrollpanelen 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 -> 15/06/2009 (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 15 juni 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ändigt datum ("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"	Fullständigt datum/tid-mönster (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/tid-mönster (kort tid). Mer information: Formatspecificeraren för generell kort tid ("g").	2009-06-15T13:45:30 -> 2009-06-15 13:45 (en-US) 2009-06-15T13:45:30 -> 15/06/2009 13:45 (es-ES) 2009-06-15T13:45:30 -> 2009/6/15 13:45 (zh-CN)
"G"	Allmänt datum/tid-mönster (lång tid). Mer information: Formatspecificeraren för allmänt datum ("G").	2009-06-15T13:45:30 -> 2009-06-15 13:45: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: Formatspecificeraren month ("M", "m").	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: Formatspecificeraren rundresa ("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.000000Z 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 indata: 2009-06-15T13:45:30 -> mån, 15 jun 2009 20:45:30 GMT DateTime indata: 2009-06-15T13:45:30 -> mån, 15 jun 2009 13:45:30 GMT
"s"	Sorterbart datum/tid-mö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 mönster för fullständigt datum/tid. Mer information: Den universella fullständiga formatspecificeraren ("U").	2009-06-15T13:45:30 -> måndag 15 juni 2009 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"	Mönster för årsmånad. 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 enskilda tecken	Okänd specificerare.	Genererar en körnings-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 sträng i anpassat format är att även om aliaset fortfarande är invariant kan 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 "åååå/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 nuvarande 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 den kultur 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 kultur.

// 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

Anmärkning

Information om hur du anpassar mönster eller strängar som används i formatering av datum- och tidsvärden finns i avsnittet NumberFormatInfo klass.

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 standardformatsträngar för datum och tid.

Standardformatsträng	Definieras av egenskapen DateTimeFormatInfo.InvariantInfo	Sträng för anpassat format
"O" eller "o"	Ingen	yyyyy'-'MM'-'dd'T'HH':'mm':'ss'.' fffffffK
"R" eller "r"	RFC1123Pattern	ddd, dd MMM ååååå HH':'mm':ss 'GMT'
"s"	SortableDateTimePattern	yyyyy'-'MM'-'dd'T'HH':'mm':'ss
"u"	UniversalSortableDateTimePattern	yyyyy'-'MM'-'dd HH':'mm':'ss'Z'

Standardformatsträngar kan också användas för att parsa åtgärder med metoderna DateTime.ParseExact 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 lyckas fortfarande. Du kan fastställa den anpassade formatsträngen eller strängarna som motsvarar en standardformatsträng genom att anropa metoden DateTimeFormatInfo.GetAllDateTimePatterns(Char). I följande exempel visas de anpassade formatsträngar som mappas 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($"   {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 standardformatsspecificerarna 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 som returneras av egenskapen ShortDatePattern i den invarianta kulturen "MM/dd/åååå".

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

Fastighet	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

Fastighet	Beskrivning
LongDatePattern	Definierar det övergripande formatet för resultatsträngen.
DayNames	Definierar de lokaliserade dagnamn som kan visas i resultatsträngen.
MonthNames	Definierar de lokaliserade månadsnamn som kan visas i resultatsträngen.

Fastighet	Beskrivning
LongDatePattern	Definierar formatet för datumkomponenten i resultatsträngen.
ShortTimePattern	Definierar formatet för tidskomponenten i resultatsträngen.
DayNames	Definierar de lokaliserade dagnamn som kan visas i resultatsträngen.
MonthNames	Definierar de lokaliserade månadsnamn 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 klockan 12 på en 12-timmarsklocka.
PMDesignator	Definierar strängen som anger tider från 12:00 till före midnatt i en 12-timmarsklocka.

Fastighet	Beskrivning
FullDateTimePattern	Definierar det övergripande formatet för resultatsträngen.
DayNames	Definierar de lokaliserade dagnamn som kan visas i resultatsträngen.
MonthNames	Definierar de lokaliserade månadsnamn 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 klockan 12 på en 12-timmarsklocka.
PMDesignator	Definierar strängen som anger tider från 12:00 till före midnatt i en 12-timmarsklocka.

Fastighet	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 å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 klockan 12 på en 12-timmarsklocka.
PMDesignator	Definierar strängen som anger tider från 12:00 till före midnatt i en 12-timmarsklocka.

Fastighet	Beskrivning
RFC1123Pattern	Definierar formatet på resultatsträngen.
AbbreviatedDayNames	Definierar de förkortade dagnamn som kan visas i resultatsträngen.
AbbreviatedMonthNames	Definierar de förkortade månadsnamnen som kan visas i resultatsträngen.

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

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

Dela via

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")

Formatspecificeraren för generell kort tid ("g")

Formatspecificeraren för allmän datumlång tid ("G")

Formatspecificeraren rundresa ("O", "o")

Formatspecificeraren RFC1123 ("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")

Deldatumformat

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

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

Inställningar för Kontrollpanelen

DateTimeFormatInfo-egenskaper

Se även

Ytterligare resurser