다음을 통해 공유


DateAndTime.DateAdd 메서드

정의

지정된 시간 간격이 추가된 날짜 및 시간 값이 포함된 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 자체는 호출 프로그램에서 변경되지 않습니다.

반환

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

예외

DateValueDate로 강제 변환될 수 없습니다.

Interval가 잘못된 경우

계산된 날짜가 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.WeekdayDateInterval.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 자체는 호출 프로그램에서 변경되지 않습니다.

반환

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

예외

DateValueDate로 강제 변환될 수 없습니다.

Interval가 잘못된 경우

계산된 날짜가 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.WeekdayDateInterval.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 년; 정수 값으로 잘림

추가 정보

적용 대상