DateTime 구조체
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
일반적으로 날짜 및 시간으로 표현되는 인스턴트 시간을 나타냅니다.
public value class DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattablepublic value class DateTime : IComparable, IConvertible, IFormattablepublic value class DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System::Runtime::Serialization::ISerializablepublic value class DateTime : IComparable, IComparable<DateTime>, IEquatable<DateTime>, IFormattablepublic struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable[System.Serializable]
public struct DateTime : IComparable, IConvertible, IFormattable[System.Serializable]
public struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System.Runtime.Serialization.ISerializablepublic struct DateTime : IComparable, IComparable<DateTime>, IEquatable<DateTime>, IFormattablepublic struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System.Runtime.Serialization.ISerializablepublic readonly struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System.Runtime.Serialization.ISerializabletype DateTime = struct
interface IConvertible
interface IFormattable[<System.Serializable>]
type DateTime = struct
interface IFormattable
interface IConvertible[<System.Serializable>]
type DateTime = struct
interface IFormattable
interface IConvertible
interface ISerializabletype DateTime = struct
interface IFormattabletype DateTime = struct
interface IConvertible
interface IFormattable
interface ISerializablePublic Structure DateTime
Implements IComparable, IComparable(Of DateTime), IConvertible, IEquatable(Of DateTime), IFormattablePublic Structure DateTime
Implements IComparable, IConvertible, IFormattablePublic Structure DateTime
Implements IComparable, IComparable(Of DateTime), IConvertible, IEquatable(Of DateTime), IFormattable, ISerializablePublic Structure DateTime
Implements IComparable, IComparable(Of DateTime), IEquatable(Of DateTime), IFormattable- 상속
- 특성
- 구현
설명
이 API에 대한 자세한 내용은 DateTime에 대한 추가 API 비고를 참조하세요.
생성자
필드
| Name | Description |
|---|---|
| MaxValue |
가능한 가장 큰 값을 DateTime나타냅니다. 이 필드는 읽기 전용입니다. |
| MinValue |
가능한 가장 작은 값을 DateTime나타냅니다. 이 필드는 읽기 전용입니다. |
| UnixEpoch |
이 상수의 값은 그레고리오력의 1970년 1월 1일 00:00:00.0000000 UTC에 해당합니다. UnixEpoch 는 Unix 시간이 0과 같은 시점을 정의합니다. |
속성
| Name | Description |
|---|---|
| Date |
이 인스턴스의 날짜 구성 요소를 가져옵니다. |
| Day |
이 인스턴스가 나타내는 월의 일을 가져옵니다. |
| DayOfWeek |
이 인스턴스가 나타내는 요일을 가져옵니다. |
| DayOfYear |
이 인스턴스가 나타내는 연도의 날을 가져옵니다. |
| Hour |
이 인스턴스가 나타내는 날짜의 시간 구성 요소를 가져옵니다. |
| Kind |
이 인스턴스가 나타내는 시간이 현지 시간, UTC(협정 세계시) 또는 둘 다에 기반하지 않는지 여부를 나타내는 값을 가져옵니다. |
| Millisecond |
이 인스턴스가 나타내는 날짜의 밀리초 구성 요소를 가져옵니다. |
| Minute |
이 인스턴스가 나타내는 날짜의 분 구성 요소를 가져옵니다. |
| Month |
이 인스턴스가 나타내는 날짜의 월 구성 요소를 가져옵니다. |
| Now |
DateTime 로컬 시간으로 표현된 이 컴퓨터의 현재 날짜 및 시간으로 설정된 개체를 가져옵니다. |
| Second |
이 인스턴스가 나타내는 날짜의 초 구성 요소를 가져옵니다. |
| Ticks |
이 인스턴스의 날짜와 시간을 나타내는 틱 수를 가져옵니다. |
| TimeOfDay |
이 인스턴스의 하루 중 시간을 가져옵니다. |
| Today |
현재 날짜를 가져옵니다. |
| UtcNow |
DateTime UTC(협정 세계시)로 표현된 이 컴퓨터의 현재 날짜 및 시간으로 설정된 개체를 가져옵니다. |
| Year |
이 인스턴스가 나타내는 날짜의 연도 구성 요소를 가져옵니다. |
메서드
| Name | Description |
|---|---|
| Add(TimeSpan) | |
| AddDays(Double) |
지정된 일 수를 이 인스턴스의 값에 추가하는 새 DateTime 값을 반환합니다. |
| AddHours(Double) |
지정된 시간 수를 이 인스턴스의 값에 추가하는 새 DateTime 시간을 반환합니다. |
| AddMilliseconds(Double) |
지정된 시간(밀리초)을 이 인스턴스의 값에 추가하는 새 DateTime 값을 반환합니다. |
| AddMinutes(Double) |
지정된 시간(분)을 이 인스턴스의 값에 추가하는 새 DateTime 값을 반환합니다. |
| AddMonths(Int32) |
지정된 개월 수를 이 인스턴스의 값에 추가하는 새 DateTime 값을 반환합니다. |
| AddSeconds(Double) |
지정된 시간(초)을 이 인스턴스의 값에 추가하는 새 DateTime 값을 반환합니다. |
| AddTicks(Int64) |
지정된 틱 수를 이 인스턴스의 값에 추가하는 새 DateTime 틱을 반환합니다. |
| AddYears(Int32) |
지정된 연도 수를 이 인스턴스의 값에 추가하는 새 DateTime 연도를 반환합니다. |
| Compare(DateTime, DateTime) |
두 인스턴스를 DateTime 비교하고 첫 번째 인스턴스가 두 번째 인스턴스와 같거나 이후인지 여부를 나타내는 정수를 반환합니다. |
| CompareTo(DateTime) |
이 인스턴스의 값을 지정된 DateTime 값과 비교하고 이 인스턴스가 지정된 값보다 이전인지, 같은지 또는 이후인지를 나타내는 정수 DateTime 를 반환합니다. |
| CompareTo(Object) |
이 인스턴스의 값을 지정된 값이 포함된 지정된 개체와 비교하고 이 인스턴스가 지정된 DateTime 값보다 이전인지, 같은지 또는 이후인지를 나타내는 정수 DateTime 를 반환합니다. |
| DaysInMonth(Int32, Int32) |
지정된 월 및 연도의 일 수를 반환합니다. |
| Equals(DateTime, DateTime) |
두 DateTime 인스턴스의 날짜 및 시간 값이 같은지 여부를 나타내는 값을 반환합니다. |
| Equals(DateTime) |
이 인스턴스의 값이 지정된 DateTime 인스턴스의 값과 같은지 여부를 나타내는 값을 반환합니다. |
| Equals(Object) |
이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. |
| FromBinary(Int64) |
64비트 이진 값을 역직렬화하고 원래 직렬화된 DateTime 개체를 다시 만듭니다. |
| FromFileTime(Int64) |
지정된 Windows 파일 시간을 해당하는 현지 시간으로 변환합니다. |
| FromFileTimeUtc(Int64) |
지정된 Windows 파일 시간을 동등한 UTC 시간으로 변환합니다. |
| FromOADate(Double) |
DateTime 지정된 OLE 자동화 날짜에 해당하는 값을 반환합니다. |
| GetDateTimeFormats() |
이 인스턴스의 값을 표준 날짜 및 시간 형식 지정자가 지원하는 모든 문자열 표현으로 변환합니다. |
| GetDateTimeFormats(Char, IFormatProvider) |
이 인스턴스의 값을 지정된 표준 날짜 및 시간 형식 지정자 및 문화권별 서식 지정 정보에서 지원하는 모든 문자열 표현으로 변환합니다. |
| GetDateTimeFormats(Char) |
이 인스턴스의 값을 지정된 표준 날짜 및 시간 형식 지정자가 지원하는 모든 문자열 표현으로 변환합니다. |
| GetDateTimeFormats(IFormatProvider) |
이 인스턴스의 값을 표준 날짜 및 시간 형식 지정자 및 지정된 문화권별 서식 지정 정보에서 지원하는 모든 문자열 표현으로 변환합니다. |
| GetHashCode() |
이 인스턴스의 해시 코드를 반환합니다. |
| GetTypeCode() | |
| IsDaylightSavingTime() |
이 인스턴스가 현재 표준 시간대의 DateTime 일광 절약 시간 범위 내에 있는지 여부를 나타냅니다. |
| IsLeapYear(Int32) |
지정된 연도가 윤년인지 여부를 나타내는 값을 반환합니다. |
| Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) |
문화권별 형식 정보 및 서식 스타일을 사용하여 날짜 및 시간의 DateTime 문자열 표현이 포함된 메모리 범위를 해당 값으로 변환합니다. |
| Parse(String, IFormatProvider, DateTimeStyles) |
문화권별 서식 정보와 서식 스타일을 사용하여 날짜 및 시간의 DateTime 문자열 표현을 해당 형식으로 변환합니다. |
| Parse(String, IFormatProvider) |
문화권별 형식 정보를 사용하여 날짜 및 시간의 DateTime 문자열 표현을 해당 형식으로 변환합니다. |
| Parse(String) |
현재 문화권의 규칙을 사용하여 날짜 및 시간의 DateTime 문자열 표현을 해당 값으로 변환합니다. |
| ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) |
지정된 형식, 문화권별 서식 정보 및 스타일을 사용하여 날짜 및 시간의 DateTime 지정된 범위 표현을 해당하는 범위로 변환합니다. 문자열 표현의 형식은 지정된 형식과 정확히 일치해야 합니다. 그렇지 않은 경우 예외가 throw됩니다. |
| ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles) |
지정된 형식 배열, 문화권별 서식 정보 및 스타일을 사용하여 날짜 및 시간의 DateTime 지정된 범위 표현을 해당하는 범위로 변환합니다. 문자열 표현의 형식은 지정된 형식 중 하나 이상과 정확히 일치해야 합니다. 그렇지 않은 경우 예외가 throw됩니다. |
| ParseExact(String, String, IFormatProvider, DateTimeStyles) |
지정된 형식, 문화권별 서식 정보 및 스타일을 사용하여 날짜 및 시간의 DateTime 지정된 문자열 표현을 해당 형식으로 변환합니다. 문자열 표현의 형식은 지정된 형식과 정확히 일치해야 합니다. 그렇지 않은 경우 예외가 throw됩니다. |
| ParseExact(String, String, IFormatProvider) |
지정된 형식 및 문화권별 형식 정보를 사용하여 날짜 및 시간의 DateTime 지정된 문자열 표현을 해당 형식으로 변환합니다. 문자열 표현의 형식은 지정된 형식과 정확히 일치해야 합니다. |
| ParseExact(String, String[], IFormatProvider, DateTimeStyles) |
지정된 형식 배열, 문화권별 서식 정보 및 스타일을 사용하여 날짜 및 시간의 DateTime 지정된 문자열 표현을 해당 형식으로 변환합니다. 문자열 표현의 형식은 지정된 형식 중 하나 이상과 정확히 일치해야 합니다. 그렇지 않은 경우 예외가 throw됩니다. |
| SpecifyKind(DateTime, DateTimeKind) |
지정된 틱 수와 같지만 지정된 DateTime값으로 표시된 대로 현지 시간, UTC(협정 세계시) 또는 둘 다로 지정되지 않은 새 DateTime 개체를 DateTimeKind 만듭니다. |
| Subtract(DateTime) |
이 인스턴스의 값에서 지정된 날짜 및 시간을 빼는 새 TimeSpan 값을 반환합니다. |
| Subtract(TimeSpan) |
이 인스턴스의 DateTime 값에서 지정된 기간을 뺍니다. |
| ToBinary() |
현재 DateTime 개체를 나중에 개체를 다시 DateTime 만드는 데 사용할 수 있는 64비트 이진 값으로 직렬화합니다. |
| ToFileTime() |
현재 DateTime 개체의 값을 Windows 파일 시간으로 변환합니다. |
| ToFileTimeUtc() |
현재 DateTime 개체의 값을 Windows 파일 시간으로 변환합니다. |
| ToLocalTime() |
현재 DateTime 개체의 값을 현지 시간으로 변환합니다. |
| ToLongDateString() |
현재 DateTime 개체의 값을 해당하는 긴 날짜 문자열 표현으로 변환합니다. |
| ToLongTimeString() |
현재 DateTime 개체의 값을 해당하는 장시간 문자열 표현으로 변환합니다. |
| ToOADate() |
이 인스턴스의 값을 해당하는 OLE 자동화 날짜로 변환합니다. |
| ToShortDateString() |
현재 DateTime 개체의 값을 해당하는 짧은 날짜 문자열 표현으로 변환합니다. |
| ToShortTimeString() |
현재 DateTime 개체의 값을 해당하는 짧은 시간 문자열 표현으로 변환합니다. |
| ToString() |
현재 문화권의 서식 규칙을 사용하여 현재 DateTime 개체의 값을 해당하는 문자열 표현으로 변환합니다. |
| ToString(IFormatProvider) |
지정된 문화권별 형식 정보를 사용하여 현재 DateTime 개체의 값을 해당하는 문자열 표현으로 변환합니다. |
| ToString(String, IFormatProvider) |
지정된 형식 및 문화권별 형식 정보를 사용하여 현재 DateTime 개체의 값을 해당하는 문자열 표현으로 변환합니다. |
| ToString(String) |
지정된 형식 및 현재 문화권의 서식 규칙을 사용하여 현재 DateTime 개체의 값을 해당하는 문자열 표현으로 변환합니다. |
| ToUniversalTime() |
현재 DateTime 개체의 값을 UTC(협정 세계시)로 변환합니다. |
| TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) |
현재 datetime 인스턴스의 값을 제공된 문자 범위로 서식을 지정하려고 시도합니다. |
| TryParse(ReadOnlySpan<Char>, DateTime) |
날짜 및 시간의 지정된 문자 범위를 해당하는 문자 범위로 DateTime 변환하고 변환에 성공했는지 여부를 나타내는 값을 반환합니다. |
| TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime) |
지정된 문화권별 서식 정보 및 서식 스타일을 사용하여 날짜 및 시간의 DateTime 범위 표현을 해당하는 값으로 변환하고 변환이 성공했는지 여부를 나타내는 값을 반환합니다. |
| TryParse(String, DateTime) |
날짜 및 시간의 지정된 문자열 표현을 해당 값으로 DateTime 변환하고 변환에 성공했는지 여부를 나타내는 값을 반환합니다. |
| TryParse(String, IFormatProvider, DateTimeStyles, DateTime) |
지정된 문화권별 서식 정보 및 서식 스타일을 사용하여 날짜 및 시간의 DateTime 지정된 문자열 표현을 해당하는 값으로 변환하고 변환이 성공했는지 여부를 나타내는 값을 반환합니다. |
| TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime) |
지정된 형식, 문화권별 서식 정보 및 스타일을 사용하여 날짜 및 시간의 DateTime 지정된 범위 표현을 해당하는 범위로 변환합니다. 문자열 표현의 형식은 지정된 형식과 정확히 일치해야 합니다. 이 메서드는 변환이 성공했는지 여부를 나타내는 값을 반환합니다. |
| TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTime) |
날짜 및 시간의 지정된 문자 범위를 해당하는 문자 범위로 DateTime 변환하고 변환에 성공했는지 여부를 나타내는 값을 반환합니다. |
| TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime) |
지정된 형식, 문화권별 서식 정보 및 스타일을 사용하여 날짜 및 시간의 DateTime 지정된 문자열 표현을 해당 형식으로 변환합니다. 문자열 표현의 형식은 지정된 형식과 정확히 일치해야 합니다. 이 메서드는 변환이 성공했는지 여부를 나타내는 값을 반환합니다. |
| TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime) |
지정된 형식 배열, 문화권별 서식 정보 및 스타일을 사용하여 날짜 및 시간의 DateTime 지정된 문자열 표현을 해당 형식으로 변환합니다. 문자열 표현의 형식은 지정된 형식 중 하나 이상과 정확히 일치해야 합니다. 이 메서드는 변환이 성공했는지 여부를 나타내는 값을 반환합니다. |
연산자
| Name | Description |
|---|---|
| Addition(DateTime, TimeSpan) |
지정된 날짜 및 시간에 지정된 시간 간격을 추가하여 새 날짜와 시간을 생성합니다. |
| Equality(DateTime, DateTime) |
지정된 두 인스턴스가 같은지 여부를 확인합니다 DateTime . |
| GreaterThan(DateTime, DateTime) | |
| GreaterThanOrEqual(DateTime, DateTime) |
지정된 DateTime 날짜 및 시간이 지정된 다른 DateTime날짜와 같거나 이후인지 여부를 확인합니다. |
| Inequality(DateTime, DateTime) |
지정된 두 인스턴스가 같지 않은지 여부를 확인합니다 DateTime . |
| LessThan(DateTime, DateTime) | |
| LessThanOrEqual(DateTime, DateTime) |
지정된 DateTime 날짜 및 시간이 지정된 다른 DateTime날짜와 같거나 이전 날짜를 나타내는지 여부를 결정합니다. |
| Subtraction(DateTime, DateTime) |
지정된 날짜 및 시간을 다른 지정된 날짜 및 시간에서 빼고 시간 간격을 반환합니다. |
| Subtraction(DateTime, TimeSpan) |
지정된 날짜 및 시간에서 지정된 시간 간격을 빼고 새 날짜와 시간을 반환합니다. |
명시적 인터페이스 구현
적용 대상
스레드 보안
이 형식의 모든 멤버는 스레드로부터 안전합니다. 인스턴스 상태를 수정하는 것처럼 보이는 멤버는 실제로 새 값으로 초기화된 새 인스턴스를 반환합니다. 다른 형식과 마찬가지로 이 형식의 인스턴스를 포함하는 공유 변수에 대한 읽기 및 쓰기는 스레드 안전을 보장하기 위해 잠금으로 보호되어야 합니다.