DateAndTime.DateAdd 메서드

  • 참조

정의

네임스페이스:
Microsoft.VisualBasic
어셈블리:
Microsoft.VisualBasic.Core.dll
어셈블리:
Microsoft.VisualBasic.dll

지정된 시간 간격이 추가된 날짜 및 시간 값이 포함된 Date 값을 반환합니다.

오버로드

DateAdd(DateInterval, Double, DateTime)

지정된 시간 간격이 추가된 날짜 및 시간 값이 포함된 값을 반환합니다.
DateAdd(String, Double, Object)

지정된 시간 간격이 추가된 날짜 및 시간 값이 포함된 값을 반환합니다.

DateAdd(DateInterval, Double, DateTime)

Source:
DateAndTime.vb
Source:
DateAndTime.vb
Source:
DateAndTime.vb

지정된 시간 간격이 추가된 날짜 및 시간 값이 포함된 값을 반환합니다.

public:
 static DateTime DateAdd(Microsoft::VisualBasic::DateInterval Interval, double Number, DateTime DateValue);
public static DateTime DateAdd (Microsoft.VisualBasic.DateInterval Interval, double Number, DateTime DateValue);
static member DateAdd : Microsoft.VisualBasic.DateInterval * double * DateTime -> DateTime
Public Function DateAdd (Interval As DateInterval, Number As Double, DateValue As DateTime) As DateTime

매개 변수

Interval
DateInterval

필수 요소. 추가할 시간 간격을 나타내는 DateInterval 열거형 값 또는 문자열 식입니다.

Number
Double

필수 요소. 더할 간격의 수를 나타내는 부동 소수점 식입니다. 미래의 날짜/시간 값을 구하는 경우에는 양수이고 과거의 날짜/시간 값을 구하는 경우에는 음수입니다. Interval이 시간, 분 또는 초로 지정되는 경우에는 소수 부분이 포함될 수 있습니다. 다른 Interval 값의 경우에 Number의 소수 부분은 무시됩니다.

DateValue
DateTime

필수 요소. 간격을 더할 날짜와 시간을 나타내는 식입니다. DateValue 자체는 호출 프로그램에서 변경되지 않습니다.

반환

DateTime

지정된 시간 간격이 추가된 날짜 및 시간 값이 포함된 값입니다.

예외

InvalidCastException

DateValue가 Date로 강제 변환될 수 없습니다.

ArgumentException

Interval가 잘못된 경우

ArgumentOutOfRangeException

계산된 날짜가 0001년 1월 1일 00:00:00시 이전 또는 9999년 12월 31일 23:59:59시 이후입니다.

예제

이 예제에서는 날짜를 사용하고 함수를 DateAdd 사용하여 해당 날짜를 지정한 월 수를 나중에 표시합니다.

Dim dateEntered As String =
InputBox("Enter a date", DefaultResponse:=Date.Now.ToShortDateString)
Dim monthsEntered As String =
InputBox("Enter number of months to add", DefaultResponse:="12")

Dim dateValue As Date = Date.Parse(dateEntered)
Dim monthsValue As Integer = Integer.Parse(monthsEntered)

' Add the months to the date.
Dim newDate As Date = DateAdd(DateInterval.Month, monthsValue, dateValue)

' This statement has a string interval argument, and
' is equivalent to the above statement.
'Dim newDate As Date = DateAdd("m", monthsValue, dateValue)

MessageBox.Show("New date: " & newDate.ToShortDateString)

설명

함수를 DateAdd 사용하여 날짜에서 지정된 시간 간격을 추가하거나 뺄 수 있습니다. 예를 들어 오늘부터 30일 또는 지금 45분 전의 날짜를 계산할 수 있습니다.

에 일을 DateValue추가하려면 , 또는 DateInterval.Weekday를 DateInterval.DayOfYear사용할 DateInterval.Day수 있습니다. 및 Weekday 는 의미 있는 시간 간격이 아니므로 DayOfYear 이와 동등한 것으로 처리됩니다.

함수는 DateAdd 잘못된 날짜를 반환하지 않습니다. 필요한 경우 결과 날짜의 일 부분이 결과 연도의 결과 월의 마지막 날로 하향 조정됩니다. 다음 예제에서는 1월 31일에 한 달을 추가합니다.

Dim NextMonth As Date = DateAdd(DateInterval.Month, 1, #1/31/1995#)

이 예제에서는 가 DateAdd 아닌 #2/31/1995#를 반환합니다#2/28/1995#. 가 이#1/31/1996#면 DateValue 1996이 윤년이므로 가 반환 #2/29/1996# 됩니다.

참고

DateAdd 는 네임스페이 CurrentCulture 스에 있는 클래스의 CultureInfo 속성에서 System.Globalization 현재 달력 설정을 사용합니다. 기본값 CurrentCulture 은 제어판 설정에 따라 결정됩니다.

모든 Date 값은 구조체에서 DateTime 지원되므로 해당 메서드는 시간 간격을 추가하는 추가 옵션을 제공합니다. 예를 들어 다음과 같이 가장 가까운 밀리초로 반올림된 소수 자릿수의 일 수를 변수에 Date 추가할 수 있습니다.

Dim NextTime As Date = Now        ' Current date and time.  
NextTime = NextTime.AddDays(3.4)  ' Increment by 3 2/5 days.

인수에는 Interval 다음 설정 중 하나가 있을 수 있습니다.

열거형 값 String 추가할 시간 간격 단위
DateInterval.Day 일 하루; 정수 값으로 잘림
DateInterval.DayOfYear y 하루; 정수 값으로 잘림
DateInterval.Hour h 시간; 가장 가까운 밀리초로 반올림됨
DateInterval.Minute n 분; 가장 가까운 밀리초로 반올림됨
DateInterval.Month 분 달; 정수 값으로 잘림
DateInterval.Quarter q 분기; 정수 값으로 잘림
DateInterval.Second 초 두 번째; 가장 가까운 밀리초로 반올림됨
DateInterval.Weekday w 하루; 정수 값으로 잘림
DateInterval.WeekOfYear ww 주; 정수 값으로 잘림
DateInterval.Year yyyy 년; 정수 값으로 잘림

추가 정보

적용 대상

DateAdd(String, Double, Object)

Source:
DateAndTime.vb
Source:
DateAndTime.vb
Source:
DateAndTime.vb

지정된 시간 간격이 추가된 날짜 및 시간 값이 포함된 값을 반환합니다.

public:
 static DateTime DateAdd(System::String ^ Interval, double Number, System::Object ^ DateValue);
public static DateTime DateAdd (string Interval, double Number, object? DateValue);
public static DateTime DateAdd (string Interval, double Number, object DateValue);
static member DateAdd : string * double * obj -> DateTime
Public Function DateAdd (Interval As String, Number As Double, DateValue As Object) As DateTime

매개 변수

Interval
String

필수 요소. 추가할 시간 간격을 나타내는 DateInterval 열거형 값 또는 문자열 식입니다.

Number
Double

필수 요소. 더할 간격의 수를 나타내는 부동 소수점 식입니다. Number는 미래의 날짜/시간 값을 구하는 경우에는 양수이고 과거의 날짜/시간 값을 구하는 경우에는 음수입니다. Interval이 시간, 분 또는 초로 지정되는 경우에는 소수 부분이 포함될 수 있습니다. 다른 Interval 값의 경우에 Number의 소수 부분은 무시됩니다.

DateValue
Object

필수 요소. 간격을 더할 날짜와 시간을 나타내는 식입니다. DateValue 자체는 호출 프로그램에서 변경되지 않습니다.

반환

DateTime

지정된 시간 간격이 추가된 날짜 및 시간 값이 포함된 값입니다.

예외

InvalidCastException

DateValue가 Date로 강제 변환될 수 없습니다.

ArgumentException

Interval가 잘못된 경우

ArgumentOutOfRangeException

계산된 날짜가 0001년 1월 1일 00:00:00시 이전 또는 9999년 12월 31일 23:59:59시 이후입니다.

예제

이 예제에서는 날짜를 사용하고 함수를 DateAdd 사용하여 해당 날짜를 지정한 월 수를 나중에 표시합니다.

Dim dateEntered As String =
InputBox("Enter a date", DefaultResponse:=Date.Now.ToShortDateString)
Dim monthsEntered As String =
InputBox("Enter number of months to add", DefaultResponse:="12")

Dim dateValue As Date = Date.Parse(dateEntered)
Dim monthsValue As Integer = Integer.Parse(monthsEntered)

' Add the months to the date.
Dim newDate As Date = DateAdd(DateInterval.Month, monthsValue, dateValue)

' This statement has a string interval argument, and
' is equivalent to the above statement.
'Dim newDate As Date = DateAdd("m", monthsValue, dateValue)

MessageBox.Show("New date: " & newDate.ToShortDateString)

설명

함수를 DateAdd 사용하여 날짜에서 지정된 시간 간격을 추가하거나 뺄 수 있습니다. 예를 들어 오늘부터 30일 또는 지금 45분 전의 날짜를 계산할 수 있습니다.

에 일을 DateValue추가하려면 , 또는 DateInterval.Weekday를 DateInterval.DayOfYear사용할 DateInterval.Day수 있습니다. 및 Weekday 는 의미 있는 시간 간격이 아니므로 DayOfYear 이와 동등한 것으로 처리됩니다.

함수는 DateAdd 잘못된 날짜를 반환하지 않습니다. 필요한 경우 결과 날짜의 일 부분이 결과 연도의 결과 월의 마지막 날로 하향 조정됩니다. 다음 예제에서는 1월 31일에 한 달을 추가합니다.

Dim NextMonth As Date = DateAdd(DateInterval.Month, 1, #1/31/1995#)

이 예제에서는 가 DateAdd 아닌 #2/31/1995#를 반환합니다#2/28/1995#. 가 이#1/31/1996#면 DateValue 1996이 윤년이므로 가 반환 #2/29/1996# 됩니다.

참고

DateAdd 는 네임스페이 CurrentCulture 스에 있는 클래스의 CultureInfo 속성에서 System.Globalization 현재 달력 설정을 사용합니다. 기본값 CurrentCulture 은 제어판 설정에 따라 결정됩니다.

모든 Date 값은 구조체에서 DateTime 지원되므로 해당 메서드는 시간 간격을 추가하는 추가 옵션을 제공합니다. 예를 들어 다음과 같이 가장 가까운 밀리초로 반올림된 소수 자릿수의 일 수를 변수에 Date 추가할 수 있습니다.

Dim NextTime As Date = Now        ' Current date and time.  
NextTime = NextTime.AddDays(3.4)  ' Increment by 3 2/5 days.

인수에는 Interval 다음 설정 중 하나가 있을 수 있습니다.

열거형 값 String 추가할 시간 간격 단위
DateInterval.Day 일 하루; 정수 값으로 잘림
DateInterval.DayOfYear y 하루; 정수 값으로 잘림
DateInterval.Hour h 시간; 가장 가까운 밀리초로 반올림됨
DateInterval.Minute n 분; 가장 가까운 밀리초로 반올림됨
DateInterval.Month 분 달; 정수 값으로 잘림
DateInterval.Quarter q 분기; 정수 값으로 잘림
DateInterval.Second 초 두 번째; 가장 가까운 밀리초로 반올림됨
DateInterval.Weekday w 하루; 정수 값으로 잘림
DateInterval.WeekOfYear ww 주; 정수 값으로 잘림
DateInterval.Year yyyy 년; 정수 값으로 잘림

추가 정보

적용 대상