DateTime 구조체
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
일반적으로 날짜와 시간으로 표현된 시간의 한 순간을 나타냅니다.
public value class DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattablepublic value class DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System::Runtime::Serialization::ISerializablepublic value class DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, ISpanFormattable, System::Runtime::Serialization::ISerializablepublic value class DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IParsable<DateTime>, ISpanFormattable, ISpanParsable<DateTime>, System::Runtime::Serialization::ISerializablepublic value class DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IParsable<DateTime>, ISpanFormattable, ISpanParsable<DateTime>, IUtf8SpanFormattable, System::Runtime::Serialization::ISerializablepublic value class DateTime : IComparable, IConvertible, IFormattablepublic value class DateTime : IComparable, IComparable<DateTime>, IEquatable<DateTime>, IFormattablepublic struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattablepublic readonly struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System.Runtime.Serialization.ISerializablepublic readonly struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, ISpanFormattable, System.Runtime.Serialization.ISerializablepublic readonly struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IParsable<DateTime>, ISpanFormattable, ISpanParsable<DateTime>, System.Runtime.Serialization.ISerializablepublic readonly struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IParsable<DateTime>, ISpanFormattable, ISpanParsable<DateTime>, IUtf8SpanFormattable, System.Runtime.Serialization.ISerializablepublic struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System.Runtime.Serialization.ISerializable[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>, IFormattabletype DateTime = struct
interface IConvertible
interface IFormattabletype DateTime = struct
interface IConvertible
interface IFormattable
interface ISerializabletype DateTime = struct
interface IConvertible
interface ISpanFormattable
interface IFormattable
interface ISerializabletype DateTime = struct
interface IConvertible
interface IFormattable
interface IParsable<DateTime>
interface ISpanFormattable
interface ISpanParsable<DateTime>
interface ISerializabletype DateTime = struct
interface IConvertible
interface IFormattable
interface IParsable<DateTime>
interface ISpanFormattable
interface ISpanParsable<DateTime>
interface ISerializable
interface IUtf8SpanFormattabletype DateTime = struct
interface IConvertible
interface IFormattable
interface IParsable<DateTime>
interface ISpanFormattable
interface ISpanParsable<DateTime>
interface IUtf8SpanFormattable
interface ISerializable[<System.Serializable>]
type DateTime = struct
interface IFormattable
interface IConvertible[<System.Serializable>]
type DateTime = struct
interface IFormattable
interface IConvertible
interface ISerializabletype DateTime = struct
interface IFormattablePublic Structure DateTime
Implements IComparable, IComparable(Of DateTime), IConvertible, IEquatable(Of DateTime), IFormattablePublic Structure DateTime
Implements IComparable, IComparable(Of DateTime), IConvertible, IEquatable(Of DateTime), IFormattable, ISerializablePublic Structure DateTime
Implements IComparable, IComparable(Of DateTime), IConvertible, IEquatable(Of DateTime), ISerializable, ISpanFormattablePublic Structure DateTime
Implements IComparable, IComparable(Of DateTime), IConvertible, IEquatable(Of DateTime), IParsable(Of DateTime), ISerializable, ISpanFormattable, ISpanParsable(Of DateTime)Public Structure DateTime
Implements IComparable, IComparable(Of DateTime), IConvertible, IEquatable(Of DateTime), IParsable(Of DateTime), ISerializable, ISpanFormattable, ISpanParsable(Of DateTime), IUtf8SpanFormattablePublic Structure DateTime
Implements IComparable, IConvertible, IFormattablePublic Structure DateTime
Implements IComparable, IComparable(Of DateTime), IEquatable(Of DateTime), IFormattable- 상속
- 특성
- 구현
설명
이 API에 대한 자세한 내용은 DateTime에 대한 추가 API 설명을 참조하세요.
생성자
필드
| MaxValue |
DateTime의 가능한 최대값을 나타냅니다. 이 필드는 읽기 전용입니다. |
| MinValue |
DateTime의 가능한 최소값을 나타냅니다. 이 필드는 읽기 전용입니다. |
| UnixEpoch |
이 상수 값은 그레고리오력의 1970년 1월 1일 00:00:00.0000000 UTC와 같습니다. UnixEpoch는 Unix 시간이 0인 시점을 정의합니다. |
속성
| Date |
이 인스턴스의 날짜 구성 요소를 가져옵니다. |
| Day |
이 인스턴스가 나타내는 월의 일 수를 가져옵니다. |
| DayOfWeek |
이 인스턴스가 나타내는 주의 일 수를 가져옵니다. |
| DayOfYear |
이 인스턴스가 나타내는 일 수를 정수로 가져옵니다. |
| Hour |
이 인스턴스가 나타내는 날짜의 시간 구성 요소를 가져옵니다. |
| Kind |
이 인스턴스에 표시된 시간이 현지 시간 또는 UTC(협정 세계시)를 기준으로 하는지 아니면 둘 중 어느 것도 기준으로 하지 않는지를 나타내는 값을 가져옵니다. |
| Microsecond |
0에서 999 사이의 값으로 표현되는 마이크로초 구성 요소입니다. |
| Millisecond |
이 인스턴스가 나타내는 날짜의 밀리초 구성 요소를 가져옵니다. |
| Minute |
이 인스턴스가 나타내는 날짜의 분 구성 요소를 가져옵니다. |
| Month |
이 인스턴스가 나타내는 날짜의 월 구성 요소를 가져옵니다. |
| Nanosecond |
0에서 900 사이의 값으로 표현되는 나노초 구성 요소(100나노초 단위). |
| Now |
이 컴퓨터의 현재 날짜와 시간으로 설정되고 현지 시간으로 표시되는 DateTime 개체를 가져옵니다. |
| Second |
이 인스턴스가 나타내는 날짜의 초 구성 요소를 가져옵니다. |
| Ticks |
이 인스턴스의 날짜와 시간을 나타내는 틱 수를 가져옵니다. |
| TimeOfDay |
이 인스턴스에 대한 하루 중 시간을 가져옵니다. |
| Today |
현재 날짜를 가져옵니다. |
| UtcNow |
이 컴퓨터의 현재 날짜와 시간으로 설정되고 UTC(협정 세계시)로 표시되는 DateTime 개체를 가져옵니다. |
| Year |
이 인스턴스가 나타내는 날짜의 연도 구성 요소를 가져옵니다. |
메서드
| Add(TimeSpan) | |
| AddDays(Double) |
지정된 날짜 수를 이 인스턴스의 값에 더하는 새 DateTime을 반환합니다. |
| AddHours(Double) |
지정된 시간 수를 이 인스턴스의 값에 더하는 새 DateTime을 반환합니다. |
| AddMicroseconds(Double) |
지정된 수의 마이크로초를 이 instance 값에 추가하는 새 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) |
지정된 월과 연도의 날짜 수를 반환합니다. |
| Deconstruct(DateOnly, TimeOnly) | |
| Deconstruct(Int32, Int32, Int32) | |
| Equals(DateTime) |
이 인스턴스의 값이 지정된 DateTime 인스턴스의 값과 같은지를 나타내는 값을 반환합니다. |
| Equals(DateTime, DateTime) |
두 DateTime 인스턴스의 날짜 및 시간 값이 같은지 여부를 나타내는 값을 반환합니다. |
| Equals(Object) |
이 인스턴스가 지정된 개체와 같은지를 나타내는 값을 반환합니다. |
| FromBinary(Int64) |
64비트 이진 값을 역직렬화하고 직렬화된 원본 DateTime 개체를 다시 만듭니다. |
| FromFileTime(Int64) |
지정한 Windows 파일 시간을 해당 현지 시간으로 변환합니다. |
| FromFileTimeUtc(Int64) |
지정한 Windows 파일 시간을 해당 UTC 시간으로 변환합니다. |
| FromOADate(Double) |
지정된 OLE 자동화 날짜에 해당하는 DateTime을 반환합니다. |
| GetDateTimeFormats() |
이 인스턴스의 값을 표준 날짜 및 시간 서식 지정자에서 지원하는 모든 문자열 표현으로 변환합니다. |
| GetDateTimeFormats(Char) |
이 인스턴스의 값을 지정된 표준 날짜 및 시간 서식 지정자에서 지원하는 모든 문자열 표현으로 변환합니다. |
| GetDateTimeFormats(Char, IFormatProvider) |
이 인스턴스의 값을 지정된 표준 날짜 및 시간 서식 지정자와 문화권별 서식 지정 정보에서 지원하는 모든 문자열 표현으로 변환합니다. |
| GetDateTimeFormats(IFormatProvider) |
이 인스턴스의 값을 표준 날짜 및 시간 서식 지정자와 지정된 문화권별 서식 지정 정보에서 지원하는 모든 문자열 표현으로 변환합니다. |
| GetHashCode() |
이 인스턴스의 해시 코드를 반환합니다. |
| GetTypeCode() | |
| IsDaylightSavingTime() |
DateTime의 이 인스턴스가 현재 시간대의 일광 절약 시간 범위 내에 있는지를 나타냅니다. |
| IsLeapYear(Int32) |
지정된 연도가 윤년인지를 나타내는 표시를 반환합니다. |
| Parse(ReadOnlySpan<Char>, IFormatProvider) |
문자 범위를 값으로 구문 분석합니다. |
| Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) |
문화권별 형식 정보 및 서식 지정 스타일을 사용하여 날짜 및 시간의 문자열 표현을 포함하는 메모리 범위를 동등한 해당 DateTime으로 변환합니다. |
| Parse(String) |
현재 문화권의 규칙을 사용하여 날짜 및 시간의 DateTime 문자열 표현을 해당 항목으로 변환합니다. |
| Parse(String, IFormatProvider) |
문화권별 형식 정보를 사용하여 날짜 및 시간의 문자열 표현을 해당 DateTime으로 변환합니다. |
| Parse(String, IFormatProvider, DateTimeStyles) |
문화권별 형식 정보 및 서식 지정 스타일을 사용하여 날짜 및 시간의 문자열 표현을 해당 DateTime으로 변환합니다. |
| ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles) |
지정된 형식, 문화권별 형식 정보 및 스타일을 사용하여 날짜 및 시간의 지정된 범위 표현을 해당하는 DateTime(으)로 변환합니다. 문자열 표현의 서식은 지정된 서식과 정확하게 일치해야 합니다. 그렇지 않으면 예외가 throw됩니다. |
| ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles) |
지정된 형식 배열, 문화권별 형식 정보 및 스타일을 사용하여 지정된 날짜와 시간의 범위 표현을 해당하는 DateTime(으)로 변환합니다. 문자열 표현의 서식은 지정된 형식 중 최소한 하나와 정확하게 일치해야 합니다. 그렇지 않으면 예외가 throw됩니다. |
| ParseExact(String, String, IFormatProvider) |
지정된 형식 및 문화권별 형식 정보를 사용하여 날짜 및 시간의 지정된 문자열 표현을 해당 DateTime으로 변환합니다. 문자열 표현의 형식이 지정된 형식과 정확하게 일치해야 합니다. |
| ParseExact(String, String, IFormatProvider, DateTimeStyles) |
지정된 형식, 문화권별 형식 정보 및 스타일을 사용하여 날짜 및 시간의 지정된 문자열 표현을 해당 DateTime으로 변환합니다. 문자열 표현의 서식은 지정된 서식과 정확하게 일치해야 합니다. 그렇지 않으면 예외가 throw됩니다. |
| ParseExact(String, String[], IFormatProvider, DateTimeStyles) |
지정된 형식 배열, 문화권별 형식 정보 및 스타일을 사용하여 지정된 날짜와 시간의 문자열 표현을 해당 DateTime 표현으로 변환합니다. 문자열 표현의 서식은 지정된 형식 중 최소한 하나와 정확하게 일치해야 합니다. 그렇지 않으면 예외가 throw됩니다. |
| SpecifyKind(DateTime, DateTimeKind) |
지정된 DateTime과 틱 수가 같지만 지정된 DateTime 값이 나타내듯이 현지 시간 또는 UTC(협정 세계시)로 지정되거나 둘 중 어느 것으로도 지정되지 않은 새 DateTimeKind 개체를 만듭니다. |
| Subtract(DateTime) |
이 인스턴스의 값에서 지정된 날짜와 시간을 뺀 새 TimeSpan을 반환합니다. |
| Subtract(TimeSpan) |
이 인스턴스의 값에서 지정된 기간을 뺀 새 DateTime을 반환합니다. |
| ToBinary() |
현재 DateTime 개체를 나중에 DateTime 개체를 다시 만드는 데 사용할 수 있는 64비트 이진 값으로 serialize합니다. |
| 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) |
현재 문화권의 형식 규칙과 지정된 형식을 사용하여 현재 DateTime 개체의 값을 해당하는 문자열 표현으로 변환합니다. |
| ToString(String, IFormatProvider) |
지정된 형식 및 문화권별 형식 정보를 사용하여 현재 DateTime 개체의 값을 해당 문자열 표현으로 변환합니다. |
| ToUniversalTime() |
현재 DateTime 개체의 값을 UTC(협정 세계시)로 변환합니다. |
| TryFormat(Span<Byte>, Int32, ReadOnlySpan<Char>, IFormatProvider) |
현재 instance 값의 형식을 제공된 바이트 범위로 UTF-8로 지정하려고 합니다. |
| TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) |
현재 datetime 인스턴스 값의 형식을 제공된 문자 범위로 지정하려고 시도합니다. |
| TryParse(ReadOnlySpan<Char>, DateTime) |
날짜와 시간에 대한 지정된 문자 범위를 해당하는 DateTime(으)로 변환하고, 변환에 성공했는지를 나타내는 값을 반환합니다. |
| TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTime) |
문자 범위를 값으로 구문 분석하려고 합니다. |
| TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime) |
지정된 문화권별 형식 정보 및 서식 지정 스타일을 사용하여 날짜 및 시간의 범위 표현을 해당하는 DateTime(으)로 변환하고 변환에 성공했는지를 나타내는 값을 반환합니다. |
| TryParse(String, DateTime) |
날짜와 시간에 대한 지정된 문자열 표현을 해당 DateTime 요소로 변환하고, 변환에 성공했는지를 나타내는 값을 반환합니다. |
| TryParse(String, IFormatProvider, 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 표현으로 변환합니다. 문자열 표현 형식은 지정된 형식과 정확히 일치해야 합니다. 이 메서드는 변환이 성공했는지 아니면 실패했는지를 나타내는 값을 반환합니다. |
연산자
| 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) |
지정된 날짜와 시간에서 지정된 시간 간격을 빼고 새 날짜와 시간을 반환합니다. |
명시적 인터페이스 구현
적용 대상
스레드 보안
이 형식의 모든 멤버는 스레드로부터 안전합니다. instance 상태를 수정하는 것처럼 보이는 멤버는 실제로 새 값으로 초기화된 새 instance 반환합니다. 다른 형식과 마찬가지로 이 형식의 instance 포함된 공유 변수를 읽고 쓰는 것은 스레드 안전을 보장하기 위해 잠금으로 보호되어야 합니다.
추가 정보
.NET
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기