DateAndTime.TimeSerial(Int32, Int32, Int32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает значение, представляющее указанный Date час, минуту и секунду, с указанием сведений о дате относительно 1 января 1 года.
public:
static DateTime TimeSerial(int Hour, int Minute, int Second);public static DateTime TimeSerial(int Hour, int Minute, int Second);static member TimeSerial : int * int * int -> DateTimePublic Function TimeSerial (Hour As Integer, Minute As Integer, Second As Integer) As DateTimeПараметры
- Hour
- Int32
Обязательно. Целочисленное выражение от 0 до 23. Однако значения за пределами этого диапазона также принимаются.
- Minute
- Int32
Обязательно. Целочисленное выражение от 0 до 59. Однако значения за пределами этого диапазона также принимаются. Значение Minute добавляется в вычисляемый час, поэтому отрицательное значение указывает минуты до этого часа.
- Second
- Int32
Обязательно. Целочисленное выражение от 0 до 59. Однако значения за пределами этого диапазона также принимаются. Значение Second добавляется в вычисляемую минуту, поэтому отрицательное значение указывает секунды до этой минуты.
Возвращаемое значение
Date Значение, представляющее указанный час, минуту и секунду, с указанием сведений о дате относительно 1 января 1 года.
Исключения
Аргумент выходит за пределы диапазона -2 147 483 648 до 2 147 483 647
Вычисляемое время меньше отрицательного 24 часа.
Примеры
В следующем примере функция используется TimeSerial для возврата времени для указанного часа, минуты и секунды.
Dim thisTime As Date
thisTime = TimeSerial(16, 35, 17)
Комментарии
В следующем примере показаны отрицательные, нулевые и положительные значения аргументов. Функция TimeSerial возвращает время, представляющее 15 минут до трех часов до полудня или 8:45:00.
Dim alarmTime As Date = TimeSerial(12 - 3, -15, 0)
Minute
Second Если или превышает его обычный диапазон, он применяется к следующей большей единице соответствующим образом. Например, если задано значение 75 минут, оно преобразуется в 1 час 15 минут.
TimeSerial уменьшает общее количество секунд в 86 400 секунд, что является числом секунд в день. Поэтому возвращаемое время всегда составляет от 00:00:00 до 23:59:59.
Тип Date данных включает компоненты даты.
TimeSerial Задает для всех этих значений значение 1, поэтому возвращаемое значение представляет первый день года 1. Однако если значения аргументов вызывают превышение вычисляемого времени в течение 24 часов, день увеличивается по мере необходимости. В следующем примере значения Hour и Minute приводят к объединенному времени более 24 часов.
MsgBox(TimeSerial(23, 75, 0))
' The preceding statement displays "1/2/0001 12:15:00 AM".
Если значения аргументов приводят к отрицательному вычисляемой времени, то для данных даты задано значение 1/1/0001, а сведения о времени корректируются в диапазоне от 00:00:00 до 23:59:59:59. Однако если вычисляемое время меньше отрицательного 24 часа, ArgumentOutOfRangeException возникает ошибка.
Так как каждое Date значение поддерживается структурой System.DateTime , его методы предоставляют дополнительные параметры при сборке Date значения. Например, можно использовать один из перегруженных DateTime конструкторов для заполнения Date переменной с помощью требуемого сочетания компонентов. Следующий пример задает newDateTime значение 6 мая 1978 г. на одну десятую секунду до 8:30 утра:
Dim newDateTime As Date = New Date(1978, 5, 6, 8, 29, 59, 900)
