DateTimePicker.CustomFormat 속성

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

사용자가 지정한 날짜 및 시간 서식 문자열을 가져오거나 설정합니다.

public:
 property System::String ^ CustomFormat { System::String ^ get(); void set(System::String ^ value); };

public string? CustomFormat { get; set; }

member this.CustomFormat : string with get, set

Public Property CustomFormat As String

속성 값

String

사용자가 지정한 날짜 및 시간 서식을 나타내는 문자열입니다. 기본값은 null입니다.

예제

다음 코드 예제에서는 설정 된 CustomFormat "6 월 01, 2001 - 금요일"로 날짜를 표시 하는 속성 DateTimePicker 입니다. 이 코드에서는 컨트롤의 인스턴스가 DateTimePicker 에 생성되었다고 가정합니다 Form.

public:
   void SetMyCustomFormat()
   {
      // Set the Format type and the CustomFormat string.
      dateTimePicker1->Format = DateTimePickerFormat::Custom;
      dateTimePicker1->CustomFormat = "MMMM dd, yyyy - dddd";
   }

public void SetMyCustomFormat()
{
   // Set the Format type and the CustomFormat string.
   dateTimePicker1.Format = DateTimePickerFormat.Custom;
   dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd";
}

Public Sub SetMyCustomFormat()
    ' Set the Format type and the CustomFormat string.
    dateTimePicker1.Format = DateTimePickerFormat.Custom
    dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd"
End Sub

설명

날짜 및 시간 구분 기호가 포함된 문자열 리터럴을 표시하거나 문자열의 서식을 지정하려면 부분 문자열에서 이스케이프 문자를 사용해야 합니다. 예를 들어 날짜를 "6월 15일 오후 12시"로 표시하려면 속성을 "MMMM dd 'at' t:mm tt"로 설정합니다 CustomFormat . "at" 부분 문자열이 이스케이프 문자로 묶이지 않으면 "t" 문자가 한 글자 A.M./P.M. 서식 문자열로 읽기 때문에 결과는 "6월 15일 aP 12:00PM"입니다(아래 서식 문자열 표 참조).

형식 문자열을 결합하여 날짜와 시간의 서식을 지정할 수 있습니다. 예를 들어 날짜 및 시간을 2001/15/12:00 PM으로 표시하려면 이 속성을 "MM'/'dd'/'yyyy hh':'mm tt"로 설정해야 합니다. 자세한 내용은 사용자 지정 날짜 및 시간 형식 문자열을 참조하세요.

참고

Format 표시된 날짜 및 시간의 서식에 영향을 주려면 이 속성에 대해 속성을 로 설정 DateTimePickerFormat.Custom 해야 합니다.

다음 표에는 유효한 모든 형식 문자열과 해당 설명이 나와 있습니다.

형식 문자열	Description
일	1자리 또는 2자리 일입니다.
dd	두 자리 날짜입니다. 한 자리 일 값 앞에 0이 옵니다.
ddd	3자의 요일 약어입니다.
dddd	전체 요일 이름입니다.
h	12시간 형식의 1자리 또는 2자리 시간입니다.
hh	12시간 형식의 두 자리 시간입니다. 한 자리 값 앞에 0이 옵니다.
H	24시간 형식의 1자리 또는 2자리 시간입니다.
HH	24시간 형식의 두 자리 시간입니다. 한 자리 값 앞에 0이 옵니다.
분	1자리 또는 2자리 분입니다.
MM	두 자리 분입니다. 한 자리 값 앞에 0이 옵니다.
M	1자리 또는 2자리 월 번호입니다.
MM	두 자리 월 번호입니다. 한 자리 값 앞에 0이 옵니다.
MMM	3자 월 약어입니다.
MMMM	전체 월 이름입니다.
초	1자리 또는 2자리 초입니다.
ss	두 자리 초입니다. 한 자리 값 앞에 0이 옵니다.
t	한 글자 A.M./P.M. 약어(오전은 "A"로 표시됨).
tt	두 글자 A.M./P.M. 약어(오전은 "AM"로 표시됨)입니다.
y	한 자리 연도(2001년은 "1"로 표시됨).
yy	연도의 마지막 두 자리 숫자(2001은 "01"로 표시됨).
yyyy	전체 연도(2001년은 "2001"로 표시됨).

추가 정보

• DateTimePickerFormat
• Format