DateAndTime.TimeSerial(Int32, Int32, Int32) Метод

Определение

Возвращает значение типа Date, представляющее заданный час, минуту и секунду, при этом дата установлена относительно 1 января 1 года.Returns a Date value representing a specified hour, minute, and second, with the date information set relative to January 1 of the year 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 -> DateTime
Public Function TimeSerial (Hour As Integer, Minute As Integer, Second As Integer) As DateTime

Параметры

Hour
Int32

Обязательный элемент.Required. Целочисленное выражение со значениями от 0 до 23.Integer expression from 0 through 23. Однако значения, находящиеся за пределами этого диапазона, также являются допустимыми.However, values outside this range are also accepted.

Minute
Int32

Обязательный элемент.Required. Целочисленное выражение со значениями от 0 до 59.Integer expression from 0 through 59. Однако значения, находящиеся за пределами этого диапазона, также являются допустимыми.However, values outside this range are also accepted. Значение параметра Minute добавляется к расчетному часу, и отрицательное значение указывает минуты до наступления этого часа.The value of Minute is added to the calculated hour, so a negative value specifies minutes before that hour.

Second
Int32

Обязательный элемент.Required. Целочисленное выражение со значениями от 0 до 59.Integer expression from 0 through 59. Однако значения, находящиеся за пределами этого диапазона, также являются допустимыми.However, values outside this range are also accepted. Значение параметра Second добавляется к вычисленным минутам, поэтому отрицательное значение указывает секунды до наступления этой минуты.The value of Second is added to the calculated minute, so a negative value specifies seconds before that minute.

Возвращаемое значение

DateTime

Значение типа Date, представляющее заданный час, минуту и секунду, при этом дата установлена относительно 1 января 1 года.A Date value representing a specified hour, minute, and second, with the date information set relative to January 1 of the year 1.

Исключения

Значение аргумента находится вне диапазона от -2147483648 до 2147483647An argument is outside the range -2,147,483,648 through 2,147,483,647

Вычисленное время меньше, чем –24 (отрицательное значение) часа.Calculated time is less than negative 24 hours.

Примеры

В следующем примере функция TimeSerial используется для возврата времени для указанного часа, минуты и секунды.The following example uses the TimeSerial function to return a time for the specified hour, minute, and second.

Dim thisTime As Date
thisTime = TimeSerial(16, 35, 17)

Комментарии

В следующем примере показаны отрицательные, нулевые и положительные значения аргументов.The following example demonstrates negative, zero, and positive argument values. Функция TimeSerial Возвращает время, представляющее 15 минут до полудня, или 8:45:00 AM.The TimeSerial function returns a time representing 15 minutes before three hours before noon, or 8:45:00 AM.

Dim alarmTime As Date = TimeSerial(12 - 3, -15, 0)  

Если значение Minute или Second выходит за пределы обычного диапазона, оно применяется к следующей более крупной единице, если это необходимо.If either Minute or Second exceeds its normal range, it is applied to the next larger unit as appropriate. Например, если указать 75 минут, оно будет оцениваться как один час и 15 минут.For example, if you specify 75 minutes, it is evaluated as one hour and 15 minutes.

TimeSerial сокращает общую сумму секунд по модулю 86 400, которая представляет собой количество секунд в дне.TimeSerial reduces the total seconds modulo 86,400, which is the number of seconds in a day. Таким образом, возвращенное время всегда находится в диапазоне от 00:00:00 до 23:59:59.Therefore, the returned time is always between 00:00:00 and 23:59:59.

Тип данных Date включает компоненты даты.The Date data type includes date components. TimeSerial устанавливает все эти значения равными 1, поэтому возвращаемое значение представляет первый день года 1.TimeSerial sets all of these to 1, so the returned value represents the first day of the year 1. Однако если значения аргументов приводят к вычисленному времени более 24 часов, при необходимости день увеличивается.However, if the values of the arguments cause the calculated time to exceed 24 hours, the day is incremented as necessary. В следующем примере значения Hour и Minute приводят к Объединенному времени более 24 часов.In the following example, the values of Hour and Minute result in a combined time of more than 24 hours.

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.If the values of the arguments result in a negative calculated time, the date information is set to 1/1/0001 and the time information is adjusted to be between 00:00:00 and 23:59:59. Однако если вычисленное время меньше, чем отрицательные 24 часа, возникает ошибка ArgumentOutOfRangeException.However, if the calculated time is less than negative 24 hours, an ArgumentOutOfRangeException error occurs.

Поскольку все значения Date поддерживаются структурой System.DateTime, ее методы предоставляют дополнительные возможности в сборке значения Date.Since every Date value is supported by a System.DateTime structure, its methods give you additional options in assembling a Date value. Например, можно использовать один из перегруженных конструкторов DateTime, чтобы заполнить переменную Date, используя нужное сочетание компонентов.For example, you can employ one of the overloaded DateTime constructors to populate a Date variable using the desired combination of components. В следующем примере задается значение newDateTime 6 мая 1978 в десятую часть секунды до 8:30 утра:The following example sets newDateTime to May 6, 1978 at one tenth of a second before 8:30 in the morning:

Dim newDateTime As Date = New Date(1978, 5, 6, 8, 29, 59, 900)  

Применяется к

Дополнительно