표준 날짜 및 시간 서식 문자열

아티클
04/08/2023

표준 날짜 및 시간 서식 문자열은 단일 문자를 서식 지정자로 사용하여 DateTime 또는 DateTimeOffset 값의 텍스트 표현을 정의합니다. 공백을 포함하여 문자를 둘 이상 포함하는 날짜 및 시간 서식은 사용자 지정 날짜 및 시간 서식 문자열로 해석됩니다. 표준 또는 사용자 지정 서식 문자열은 다음 두 가지 방법으로 사용할 수 있습니다.

서식 지정 작업의 결과로 생성되는 문자열을 정의합니다.
구문 분석 작업을 통해 DateTime 또는 DateTimeOffset 값으로 변환할 수 있는 날짜 및 시간 값의 텍스트 표현을 정의합니다.

팁

숫자 또는 날짜 및 시간 값에 서식 문자열을 적용하고 결과 문자열을 표시할 수 있는 .NET Windows Forms 애플리케이션인 Formatting Utility를 다운로드할 수 있습니다. C# 및 Visual Basic의 소스 코드를 사용할 수 있습니다.

참고

이 문서의 일부 C# 예제는 Try.NET 인라인 코드 실행기 및 플레이그라운드에서 실행됩니다. 대화형 창에서 예제를 실행하려면 실행 버튼을 선택합니다. 코드를 실행하면 실행을 다시 선택하여 코드를 수정하고 수정된 코드를 실행할 수 있습니다. 수정된 코드는 대화형 창에서 실행되거나, 컴파일이 실패하면 대화형 창에 모든 C# 컴파일러 오류 메시지가 표시됩니다.

Try.NET 인라인 코드 러너와 플레이그라운드의 현지 표준 시간대는 협정 세계시(또는 UTC)입니다. 이는 DateTime, DateTimeOffset 및 TimeZoneInfo 형식과 이러한 형식의 멤버를 보여주는 예제의 동작 및 출력에 영향을 줄 수 있습니다.

서식 지정자 테이블

다음 표에서는 표준 날짜 및 시간 서식 지정자에 대해 설명합니다. 다른 설명이 없는 한 특정 표준 날짜 및 시간 서식 지정자는 DateTime 값에 사용할 때와 DateTimeOffset 값에 사용할 때 동일한 문자열을 생성합니다. 표준 날짜 및 시간 서식 문자열에 대한 자세한 내용은 제어판 설정과 DateTimeFormatInfo 속성을 참조하세요.

형식 지정자	설명	예제
"d"	간단한 날짜 패턴입니다. 추가 정보:간단한 날짜("d") 서식 지정자.	2009-06-15T13:45:30 -> 2009년 6월 15일(en-US) 2009-06-15T13:45:30 -> 2009/15/06(fr-FR) 2009-06-15T13:45:30 -> 2009/06/15(ja-JP)
"D"	자세한 날짜 패턴입니다. 추가 정보:자세한 날짜("D") 서식 지정자.	2009-06-15T13:45:30 -> 2009년 6월 15일 월요일(en-US) 2009-06-15T13:45:30 -> понедельник, 15 июня 2009 . (ru-RU) 2009-06-15T13:45:30 -> Montag, 15. Juni 2009 (de-DE)
"f"	전체 날짜/시간 패턴(간단한 시간)입니다. 추가 정보: 전체 날짜 간단한 시간("f") 서식 지정자.	2009-06-15T13:45:30 -> 2009년 6월 15일 월요일 오후 1: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"	전체 날짜/시간 패턴(자세한 시간) 추가 정보: 전체 날짜 자세한 시간("F") 서식 지정자.	2009-06-15T13:45:30 -> 2009년 6월 15일 월요일 오후 1: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"	일반 날짜/시간 패턴(간단한 시간) 추가 정보: 일반 날짜 간단한 시간("g") 서식 지정자.	2009-06-15T13:45:30 -> 6/15/2009 오후 1: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"	일반 날짜/시간 패턴(자세한 시간)입니다. 추가 정보: 일반 날짜 자세한 시간("G") 서식 지정자.	2009-06-15T13:45:30 -> 6/15/2009 1:45:30 PM(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", "m") 서식 지정자.	2009-06-15T13:45:30 -> 6월 15일(en-US) 2009-06-15T13:45:30 -> 15. juni (da-DK) 2009-06-15T13:45:30 -> 15 Juni(id-ID)
"O", "o"	왕복 날짜/시간 패턴입니다. 추가 정보: 왕복("O", "o") 서식 지정자.	DateTime 값: 2009-06-15T13:45:30 (DateTimeKind.Local) --> 2009-06-15T13:45:30.00000000-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.00000000 DateTimeOffset 값: 2009-06-15T13:45:30-07:00 --> 2009-06-15T13:45:30.00000000-07:00
"R", "r"	RFC1123 패턴입니다. 추가 정보: RFC1123("R", "r") 서식 지정자.	DateTimeOffset 입력: 2009-06-15T13:45:30 -> 월, 15 6월 2009 20:45:30 GMT DateTime 입력: 2009-06-15T13:45:30 -> 월, 15 6월 2009 13:45:30 GMT
"s"	정렬 가능한 날짜/시간 패턴입니다. 추가 정보: 정렬 가능한("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"	간단한 시간 패턴입니다. 추가 정보: 간단한 시간("t") 서식 지정자.	2009-06-15T13:45:30 -> 오후 1:45(en-US) 2009-06-15T13:45:30 -> 13:45(hr-HR) 2009-06-15T13:45:30 -> 01:45 م(ar-EG)
"T"	자세한 시간 패턴 추가 정보: 자세한 시간("T") 서식 지정자.	2009-06-15T13:45:30 -> 오후 1: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"	정렬 가능한 유니버설 날짜/시간 패턴 추가 정보: 정렬 가능한 유니버설("u") 서식 지정자.	값 사용 DateTime : 2009-06-15T13:45:30 -> 2009-06-15 13:45:30Z 값 사용 DateTimeOffset : 2009-06-15T13:45:30 -> 2009-06-15 20:45:30Z
"U"	유니버설 전체 날짜/시간 패턴입니다. 추가 정보: 유니버설 전체("U") 서식 지정자.	2009-06-15T13:45:30 -> 2009년 6월 15일 월요일 오후 8: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"	연도 월 패턴 추가 정보: 연도 월("Y") 서식 지정자.	2009-06-15T13:45:30 -> 2009년 6월(en-US) 2009-06-15T13:45:30 -> juni 2009(da-DK) 2009-06-15T13:45:30 -> Juni 2009(id-ID)
기타 모든 단일 문자	알 수 없는 지정자입니다.	런타임 FormatException을 throw합니다.

표준 서식 문자열의 작동 방법

서식 지정 작업에서 표준 서식 문자열은 단순히 사용자 지정 서식 문자열에 대한 별칭입니다. 별칭을 사용하여 사용자 지정 서식 문자열을 참조할 경우 별칭은 변하지 않지만 사용자 지정 서식 문자열 자체는 변경될 수 있다는 장점이 있습니다. 이는 날짜 및 시간 값에 대한 문자열 표현이 일반적으로 문화권마다 다르다는 점을 감안했을 때 매우 중요한 기능입니다. 예를 들어, "d" 표준 서식 문자열은 날짜 및 시간 값을 간단한 날짜 패턴을 사용하여 표시함을 나타냅니다. 고정 문화권의 경우 이 패턴이 "MM/dd/yyyy"이고 fr-FR 문화권의 경우 "dd/MM/yyyy"이며 ja-JP 문화권의 경우 "yyyy/MM/dd"입니다.

서식 지정 작업에서 표준 서식 문자열이 특정 문화권의 사용자 지정 서식 문자열에 매핑되는 경우 애플리케이션에서는 다음 방법 중 하나로 사용할 사용자 지정 서식 문자열이 포함된 특정 문화권을 정의할 수 있습니다.

기본 또는 현재 문화권을 사용할 수 있습니다. 다음 예제에서는 현재 문화권의 간단한 날짜 서식을 사용하여 날짜를 표시합니다. 이 예제의 경우 현재 문화권이 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

사용할 서식 지정과 관련된 문화권을 나타내는 CultureInfo 개체를 IFormatProvider 매개 변수가 있는 메서드에 전달할 수 있습니다. 다음 예제에서는 pt-BR 문화권의 간단한 날짜 서식을 사용하여 날짜를 표시합니다.

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

서식 지정 정보를 제공하는 DateTimeFormatInfo 개체를 IFormatProvider 매개 변수가 있는 메서드에 전달할 수 있습니다. 다음 예제에서는 hr-HR 문화권의 DateTimeFormatInfo 개체가 제공하는 간단한 날짜 서식을 사용하여 날짜를 표시합니다.

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

참고

날짜와 시간 값 서식 지정에 사용되는 패턴 또는 문자열에 대한 자세한 내용은 NumberFormatInfo 클래스 항목을 참조하세요.

표준 서식 문자열을 보다 긴 고정 사용자 지정 서식 문자열에 대한 약식 표현으로 사용하는 경우도 있습니다. 네 개의 표준 서식 문자열이 다음 범주에 속합니다. "O" (또는 "o"), "R" (또는 "r"), "s" 및 "u". 이 문자열은 고정 문화권에 정의된 사용자 지정 서식 문자열에 대응되며, 문화권마다 동일하게 인식되는 날짜 및 시간 값에 대한 문자열 표현을 생성합니다. 다음 표에서는 이러한 네 가지 표준 날짜 및 시간 서식 문자열에 대해 설명합니다.

표준 서식 문자열	DateTimeFormatInfo.InvariantInfo 속성으로 정의된 문자열	사용자 지정 서식 문자열
"O" 또는 "o"	없음	yyyy'-'MM'-'dd'T'HH':'mm':'ss'.' fffffffK
"R" 또는 "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'

표준 서식 문자열은 입력 문자열이 특정 패턴을 정확하게 따라야 구문 분석 작업이 성공하는 DateTime.ParseExact 또는 DateTimeOffset.ParseExact 메서드의 구문 분석 작업에서도 사용할 수 있습니다. 많은 표준 서식 문자열은 여러 사용자 지정 서식 문자열로 매핑되므로 날짜 및 시간 값을 여러 서식으로 표현할 수 있으며 그래도 구문 분석 작업이 성공합니다. DateTimeFormatInfo.GetAllDateTimePatterns(Char) 메서드를 호출하면 표준 서식 문자열에 해당하는 사용자 지정 서식 문자열을 확인할 수 있습니다. 다음 예제에서는 "d"(간단한 날짜 패턴) 표준 서식 문자열로 매핑되는 사용자 지정 서식 문자열을 보여 줍니다.

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

다음 단원에서는 DateTime 및 DateTimeOffset 값에 대한 표준 서식 지정자에 대해 설명합니다.

날짜 서식

이 그룹에는 다음 서식이 포함됩니다.

간단한 날짜("d") 서식 지정자
자세한 날짜("D") 서식 지정자

간단한 날짜("d") 서식 지정자

"d" 표준 서식 지정자는 특정 문화권의 DateTimeFormatInfo.ShortDatePattern 속성에 의해 정의되는 사용자 지정 날짜 및 시간 서식 문자열을 나타냅니다. 예를 들어, 고정 문화권의 ShortDatePattern 속성이 반환하는 사용자 지정 서식 문자열은 "MM/dd/yyyy"입니다.

다음 표에서는 반환된 문자열의 서식을 제어하는 DateTimeFormatInfo 개체의 속성을 보여 줍니다.

속성	설명
ShortDatePattern	결과 문자열의 전체 서식을 정의합니다.
DateSeparator	날짜의 연도, 월 및 일 구성 요소를 구분하는 문자열을 정의합니다.

다음 예제에서는 "d" 서식 지정자를 사용하여 날짜 및 시간 값을 표시합니다.

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

속성	설명
LongDatePattern	결과 문자열의 전체 서식을 정의합니다.
DayNames	결과 문자열에 나타날 수 있는 지역화된 요일 이름을 정의합니다.
MonthNames	결과 문자열에 나타날 수 있는 지역화된 월 이름을 정의합니다.

속성	설명
LongDatePattern	결과 문자열의 날짜 구성 요소 서식을 정의합니다.
ShortTimePattern	결과 문자열의 시간 구성 요소 서식을 정의합니다.
DayNames	결과 문자열에 나타날 수 있는 지역화된 요일 이름을 정의합니다.
MonthNames	결과 문자열에 나타날 수 있는 지역화된 월 이름을 정의합니다.
TimeSeparator	시간의 시, 분 및 초 구성 요소를 구분하는 문자열을 정의합니다.
AMDesignator	12시간 서식으로 자정부터 정오까지의 시간을 나타내는 문자열을 정의합니다.
PMDesignator	12시간 서식으로 정오부터 자정까지의 시간을 나타내는 문자열을 정의합니다.

속성	설명
FullDateTimePattern	결과 문자열의 전체 서식을 정의합니다.
DayNames	결과 문자열에 나타날 수 있는 지역화된 요일 이름을 정의합니다.
MonthNames	결과 문자열에 나타날 수 있는 지역화된 월 이름을 정의합니다.
TimeSeparator	시간의 시, 분 및 초 구성 요소를 구분하는 문자열을 정의합니다.
AMDesignator	12시간 서식으로 자정부터 정오까지의 시간을 나타내는 문자열을 정의합니다.
PMDesignator	12시간 서식으로 정오부터 자정까지의 시간을 나타내는 문자열을 정의합니다.

속성	설명
ShortDatePattern	결과 문자열의 날짜 구성 요소 서식을 정의합니다.
LongTimePattern	결과 문자열의 시간 구성 요소 서식을 정의합니다.
DateSeparator	날짜의 연도, 월 및 일 구성 요소를 구분하는 문자열을 정의합니다.
TimeSeparator	시간의 시, 분 및 초 구성 요소를 구분하는 문자열을 정의합니다.
AMDesignator	12시간 서식으로 자정부터 정오까지의 시간을 나타내는 문자열을 정의합니다.
PMDesignator	12시간 서식으로 정오부터 자정까지의 시간을 나타내는 문자열을 정의합니다.

속성	설명
RFC1123Pattern	결과 문자열의 서식을 정의합니다.
AbbreviatedDayNames	결과 문자열에 나타날 수 있는 약식 요일 이름을 정의합니다.
AbbreviatedMonthNames	결과 문자열에 나타날 수 있는 약식 월 이름을 정의합니다.

속성	설명
MonthDayPattern	결과 문자열의 전체 서식을 정의합니다.
MonthNames	결과 문자열에 나타날 수 있는 지역화된 월 이름을 정의합니다.

속성	설명
YearMonthPattern	결과 문자열의 전체 서식을 정의합니다.
MonthNames	결과 문자열에 나타날 수 있는 지역화된 월 이름을 정의합니다.

표준 날짜 및 시간 서식 문자열

서식 지정자 테이블

표준 서식 문자열의 작동 방법

날짜 서식

간단한 날짜("d") 서식 지정자

자세한 날짜("D") 서식 지정자

날짜 및 시간 형식

전체 날짜,간단한 시간("f") 서식 지정자

전체 날짜, 자세한 시간("F") 서식 지정자

일반 날짜, 간단한 시간("g") 서식 지정자

일반 날짜, 자세한 시간("G") 서식 지정자

라운드트립("O", "o") 서식 지정자

RFC1123("R", "r") 서식 지정자

정렬 가능한("s") 서식 지정자

정렬 가능한 유니버설("u") 서식 지정자

유니버설 전체("U") 서식 지정자

시간 형식

간단한 시간("t") 서식 지정자

자세한 시간("T") 서식 지정자

부분적 날짜 서식

월("M", "m") 서식 지정자

년 월("Y", "y") 서식 지정자

제어판 설정

DateTimeFormatInfo 속성

참조

피드백

추가 리소스