DateAndTime.DateSerial(Int32, Int32, Int32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Date Возвращает значение, представляющее указанный год, месяц и день, при этом сведения о времени, заданное в полночь (00:00:00).
public:
static DateTime DateSerial(int Year, int Month, int Day);public static DateTime DateSerial(int Year, int Month, int Day);static member DateSerial : int * int * int -> DateTimePublic Function DateSerial (Year As Integer, Month As Integer, Day As Integer) As DateTimeПараметры
- Year
- Int32
Обязательно. Целочисленное выражение от 1 до 9999. Однако значения ниже этого диапазона также принимаются. Если Year значение равно 0–99, оно интерпретируется как от 1930 до 2029 года, как описано в разделе "Замечания". Если Year значение меньше 1, оно вычитается из текущего года.
- Month
- Int32
Обязательно. Целочисленное выражение от 1 до 12. Однако значения за пределами этого диапазона также принимаются. Значение Month смещения на 1 и применяется к январю вычисляемого года. Другими словами, (Month - 1) добавляется в январь. Год пересчитывается при необходимости. Следующие результаты иллюстрируют этот эффект:
Если Month значение равно 1, результатом является январь вычисляемого года.
Если Month значение равно 0, результатом является декабрь предыдущего года.
Если Month значение равно -1, результатом является ноябрь предыдущего года.
Если Month значение равно 13, результатом является январь следующего года.
- Day
- Int32
Обязательно. Целочисленное выражение от 1 до 31. Однако значения за пределами этого диапазона также принимаются. Значение Day смещения на 1 и применяется к первому дню вычисляемого месяца. Другими словами, (Day - 1) добавляется в первый месяц. Месяц и год пересчитываются при необходимости. Следующие результаты иллюстрируют этот эффект:
Если Day значение равно 1, результатом является первый день вычисляемого месяца.
Если Day значение равно 0, результатом является последний день предыдущего месяца.
Если Day значение равно -1, результатом является предпоследний день предыдущего месяца.
Если Day прошло конец текущего месяца, результатом является соответствующий день следующего месяца. Например, если Month значение равно 4 и Day равно 31, результат — 1 мая.
Возвращаемое значение
Значение, представляющее указанный год, месяц и день, с информацией о времени, заданной в полночь (00:00:00).
Примеры
В этом примере функция используется DateSerial для возврата даты в течение указанного года, месяца и дня.
' DateSerial returns the date for a specified year, month, and day.
Dim aDate As Date
' Variable aDate contains the date for February 12, 1969.
aDate = DateSerial(1969, 2, 12)
Console.WriteLine(aDate)
' The following example uses DateSerial to determine and display
' the last day of the previous month.
' First, establish a starting date.
Dim startDate = #1/23/1994#
' The 0 for the day represents the last day of the previous month.
Dim endOfLastMonth = DateSerial(startDate.Year, startDate.Month, 0)
Console.WriteLine("Last day in the previous month: " & endOfLastMonth)
' The following example finds and displays the day of the week that the
' 15th day of the following month will fall on.
Dim fifteenthsDay = DateSerial(Today.Year, Today.Month + 1, 15)
Console.WriteLine("The 15th of next month is a {0}", fifteenthsDay.DayOfWeek)
Комментарии
Двухзначные значения аргумента Year интерпретируются на основе пользовательских параметров компьютера. Параметры по умолчанию — это то, что значения от 0 до 29 интерпретируются как годы 2000-2029, а значения от 30 до 99 лет интерпретируются как годы 1930-1999. Для обозначения всех остальных лет используйте четырехзначный год, например 1924.
В следующем примере показаны отрицательные, нулевые и положительные значения аргументов.
DateSerial Здесь функция возвращает Date представление дня перед первым днем марта в течение 10 лет до текущего года, иными словами, последний день февраля назад.
Dim EndFeb As Date = DateSerial(-10, 3, 0)
Month
Day Если или превышает его обычный диапазон, он применяется к следующей большей единице соответствующим образом. Например, если указать 32 дня, оно оценивается как один месяц и от одного до четырех дней в зависимости от значения Month. Если Year аргумент больше 9999 или какой-либо аргумент находится за пределами диапазона -2 147 483 648 до 2 147 483 647, ArgumentException возникает ошибка. Если дата, указанная тремя аргументами, превышает 00:00:00 1 января 1 или более поздней версии 23:59:59 31 декабря 9999 года, ArgumentOutOfRangeException возникает ошибка.
Тип Date данных включает компоненты времени.
DateSerial Задает для всех этих значений значение 0, поэтому возвращаемое значение представляет начало вычисляемого дня.
Так как каждое Date значение поддерживается структурой DateTime , его методы предоставляют дополнительные параметры при сборке Date значения. Например, можно использовать один из перегруженных DateTime конструкторов для заполнения Date переменной с помощью требуемого сочетания компонентов. Следующий пример задает NewDateTime значение 6 мая 1978 г. на одну десятую секунду до 8:30 утра:
Dim NewDateTime As Date = New Date(1978, 5, 6, 8, 29, 59, 900)
