Връща стойност от тип Variant (Date) за указана година, месец и ден.
Синтаксис
DateSerial ( година; месец; ден )
Предупреждение Уверете се, че аргументите са в правилния диапазон от стойности. Невалиден аргумент може да доведе до неправилен резултат.
Синтаксисът на функцията DateSerial има следните аргументи:
|
Аргумент |
Описание |
|
година |
Задължително. Цяло число. Число между 100 и 9999 включително или числов израз. |
|
месец |
Задължително. Цяло число. Всеки числов израз. |
|
ден |
Задължително. Цяло число. Всеки числов израз. |
Забележки
За да зададете дата, например 31 декември 1991 г., диапазонът от числа за всякааргументDateSerial трябва да бъде в приетия диапазон за единицата; т.е. 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, възниква грешка. Ако датата, зададена от трите аргумента, е извън допустимия диапазон от дати, ще възникне грешка.
Забележка: За година, месец и ден, ако настройката на свойството Календар е Григорианска, подадената стойност се приема за григорианска. Ако настройката на свойството Календар е Хиджри, подадената стойност се приема за Хиджри.
Върнатата част за дата е в мерните единици за времевия период на текущия календар на 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.
