DateTimePicker.CustomFormat 속성

아티클
08/21/2007

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

네임스페이스: System.Windows.Forms
어셈블리: System.Windows.Forms(system.windows.forms.dll)

구문

‘선언
<LocalizableAttribute(True)> _
Public Property CustomFormat As String
‘사용 방법
Dim instance As DateTimePicker
Dim value As String

value = instance.CustomFormat

instance.CustomFormat = value

[LocalizableAttribute(true)] 
public string CustomFormat { get; set; }

[LocalizableAttribute(true)] 
public:
property String^ CustomFormat {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_CustomFormat ()

/** @property */
public void set_CustomFormat (String value)

public function get CustomFormat () : String

public function set CustomFormat (value : String)

속성 값

사용자가 지정한 날짜 및 시간 형식을 나타내는 문자열입니다. 기본값은 Null 참조(Visual Basic의 경우 Nothing)입니다.

설명

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

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

참고

표시된 날짜 및 시간 형식에 이 속성을 적용하려면 Format 속성을 DateTimePickerFormat.Custom으로 설정해야 합니다.

다음 표에는 유효한 형식 문자열 및 그에 대한 설명이 들어 있습니다.

형식 문자열	설명
d	한 자리 또는 두 자리 날짜입니다.
dd	두 자리 날짜입니다. 한 자리로 된 날짜 값 앞에는 0이 옵니다.
ddd	세 문자로 된 요일 약어입니다.
dddd	요일의 전체 이름입니다.
h	12시간 형식의 한 자리 또는 두 자리 시간입니다.
hh	12시간 형식의 두 자리 시간입니다. 한 자리로 된 값 앞에는 0이 옵니다.
H	24시간 형식의 한 자리 또는 두 자리 시간입니다.
HH	24시간 형식의 두 자리 시간입니다. 한 자리로 된 값 앞에는 0이 옵니다.
m	한 자리 또는 두 자리 분입니다.
mm	두 자리 분입니다. 한 자리로 된 값 앞에는 0이 옵니다.
M	달을 나타내는 한 자리 또는 두 자리 숫자입니다.
MM	달을 나타내는 두 자리 숫자입니다. 한 자리로 된 값 앞에는 0이 옵니다.
MMM	세 문자로 된 달의 약어입니다.
MMMM	달의 전체 이름입니다.
s	한 자리 또는 두 자리 초입니다.
ss	두 자리 초입니다. 한 자리로 된 값 앞에는 0이 옵니다.
t	한 문자로 된 A.M./P.M. 약어이며, A.M.은 "A"로 표시됩니다.
tt	두 문자로 된 A.M./P.M. 약어이며, A.M.은 "AM"으로 표시됩니다.
y	한 자리 연도이며, 2001은 "1"로 표시됩니다.
yy	연도의 마지막 두 자리이며, 2001은 "01"로 표시됩니다.
yyyy	완전한 형태의 연도이며, 2001은 "2001"로 표시됩니다.

예제

다음 코드 예제에서는 CustomFormat 속성을 설정하여 DateTimePicker에서 날짜를 "June 01, 2001 - Friday"와 같이 표시하도록 합니다. 이 코드는 DateTimePicker 컨트롤의 인스턴스가 Form에 만들어진 것으로 가정합니다.

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

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 void SetMyCustomFormat()
{
    // Set the Format type and the CustomFormat string.
    dateTimePicker1.set_Format(DateTimePickerFormat.Custom);
    dateTimePicker1.set_CustomFormat("MMMM dd, yyyy - dddd");
} //SetMyCustomFormat

플랫폼

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

.NET Compact Framework

2.0에서 지원

참고 항목

참조

DateTimePicker 클래스
DateTimePicker 멤버
System.Windows.Forms 네임스페이스
DateTimePickerFormat
Format

다음을 통해 공유