Връща стойност от тип Variant (Date) за указана година, месец и ден.
Синтаксис
DateSerial(година; месец; ден)
Предупреждение Уверете се, че аргументите са в правилния диапазон от стойности. Невалиден аргумент може да доведе до неправилен резултат.
Синтаксисът на функцията DateSerial има следните аргументи:
| Аргумент | Описание |
|---|---|
| година | Задължително. Цяло. Число между 100 и 9999 включително или числов израз. |
| месец | Задължително. Цяло. Всеки числов израз. |
| ден | Задължително. Цяло. Всеки числов израз. |
Забележки
За да зададете дата, например 31 декември 1991 г., диапазонът от числа за всеки аргумент "ДатаСерия " трябва да бъде в приетия за единицата диапазон; т.е. 1 – 31 за дни и 1 – 12 за месеци. Можете обаче също да зададете относителни дати за всеки аргумент, като използвате всеки числов израз, който представя някакъв брой дни, месеци или години преди или след определена дата.
Следващият пример използва числови изрази вместо числа с абсолютни дати. Тук функцията DateSerial връща дата, която е денят преди първия ден (1 - 1), два месеца преди август (8 - 2), 10 години преди 1990 г. (1990 - 10); с други думи, 31 май 1980 г.
DateSerial(1990 - 10, 8 - 2, 1 - 1)
Двуцифрените години за аргумента "година " се интерпретират въз основа на дефинирани от потребителя настройки на машината. Настройките по подразбиране са, че стойности между 0 и 29 включително, се разглеждат като години 2000–2029. Стойностите по подразбиране между 30 и 99 се разглеждат като годините 1930–1999. За всички други аргументи за година използвайте четирицифрена година (например 1800).
Версии на Windows, които са по-стари от Windows 2000, интерпретират двуцифрени години въз основа на стойностите по подразбиране, описани по-горе. За да сте сигурни, че функцията връща правилната стойност, използвайте четирицифрена година.
Когато някой аргумент надвиши приетия диапазон за този аргумент, той нараства до следващата по-голяма единица според случая. Ако например укажете 35 дни, те се смятат за един месец и някакъв брой дни, в зависимост от това къде в годината се прилага. Ако някой единичен аргумент е извън диапазона от -32 768 до 32 767, възниква грешка. Ако датата, зададена от трите аргумента, излиза извън приемливия диапазон от дати, възниква грешка.
Забележка
За year,monthиday, ако настройката на свойството Calendar е григориана, предоставената стойност се приема за григорианова. Ако настройката на свойството Calendar е хиджра, предоставената стойност се приема за хиджра.
Частта за върнатата дата е в единиците за времеви период на текущия календар на Visual Basic. Ако например текущият календар е хиджри и частта за връщане за дата е годината, стойността за годината е година на хиджра. За годината на аргумента стойностите между 0 и 99 включително се разглеждат като годините 1400-1499. За всички други стойности за година използвайте цялата четирицифрена година (например 1520).
Пример за заявка
| Израз | Резултати |
|---|---|
| SELECT Dateserial(2018,12,13) AS NewDate FROM ProductSales; | Връща "датата" за указаната година, месец и ден, въведени в аргументите на функцията, и се показва в колоната "НоваДата". Резултат: "12.13.2018 г." |
Пример на VBA
Забележка
Примерите по-долу илюстрират използването на тази функция във Visual Basic for Applications (VBA). За повече информация относно работата с VBA изберете Справочни материали за разработчици в падащия списък до Търсене и въведете един или няколко термина в полето за търсене.
Този пример използва функцията DateSerial , за да върне датата за указаната година, месец и ден.
Dim MyDate ' MyDate contains the date for February 12, 1969. MyDate = DateSerial(1969, 2, 12) ' Return a date.