Връща стойност от тип 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)
Двуцифрените години за аргумента year се интерпретират на базата на дефинирани от потребителя настройки на машината. Настройката по подразбиране е, че стойности между 0 и 29 включително се разглеждат като годините 2000 – 2029. Стойностите по подразбиране между 30 и 99 се интерпретират като годините 1930 – 1999. За всички други аргументи за годината Използвайте 4-цифрена година (например 1800).
Версиите на Windows, по-стари от Windows 2000, интерпретират двуцифрени години по настройките по подразбиране, описани по-горе. За да сте сигурни, че функцията връща правилната стойност, използвайте 4-цифрена година.
Когато някой аргумент надвишава приетия диапазон за този аргумент, той се увеличава към следващата по-голяма единица по подходящ начин. Например, ако укажете 35 дни, той се изчислява като един месец и определен брой дни, в зависимост от това къде в годината се прилага. Ако някой единичен аргумент е извън диапазона-32 768 до 32 767, възниква грешка. Ако определената от трите аргумента дата е извън допустимия диапазон от дати, възниква грешка.
Забележка: За година, месециден, ако настройката на свойството Календар е григориански, предоставената стойност се приема за григориански. Ако настройката на свойството Календар е хиджри, предоставената стойност се приема за хиджри.
Частта за върната дата е в единиците за времеви период на текущия календар на Visual Basic. Например, ако текущият календар е хиджри и частта за дата, която трябва да бъде върната, е годината, стойността за годината е хиджри година. За годинатана аргументите стойности между 0 и 99, включително, се интерпретират като годините 1400-1499. За всички други стойности за годината Използвайте пълния четиригодишен календар (например 1520).
Пример за заявка
Израз |
Резултати |
Изберете Dateserial (2018; 12; 13) като NewDate от ProductSales; |
Връща "дата" за зададената година, месец и ден, въведени в аргументите на функцията и се показва в колоната "NewDate". Резултат: "13/12/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.