DateAndTime.DateSerial(Int32, Int32, Int32) Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Date A megadott évet, hónapot és napot ábrázoló értéket adja vissza, az időadatok pedig éjfélre (00:00:00).
public:
static DateTime DateSerial(int Year, int Month, int Day);public static DateTime DateSerial(int Year, int Month, int Day);static member DateSerial : int * int * int -> DateTimePublic Function DateSerial (Year As Integer, Month As Integer, Day As Integer) As DateTimeParaméterek
- Year
- Int32
Kötelező. Egész kifejezés 1 és 9999 között. A tartomány alatti értékeket azonban a rendszer elfogadja. Ha Year 0 és 99 közötti, akkor a rendszer 1930 és 2029 közötti értékként értelmezi a "Megjegyzések" szakaszban leírtak szerint. Ha Year 1-nél kisebb, akkor az aktuális évből lesz kivonva.
- Month
- Int32
Kötelező. Egész kifejezés 1 és 12 között. A tartományon kívüli értékeket azonban a rendszer elfogadja. Az érték eltolása Month 1-sel történik, és a számított év januárjára vonatkozik. Más szóval a (Month - 1) januárhoz lesz hozzáadva. Az évet szükség esetén újraszámítjuk. Az alábbi eredmények ezt a hatást szemléltetik:
Ha Month 1, az eredmény a számított év januárja.
Ha Month 0, az eredmény az előző év decembere.
Ha Month -1, az eredmény az előző év novembere.
Ha Month 13, az eredmény a következő év januárja.
- Day
- Int32
Kötelező. Egész szám kifejezés 1 és 31 között. A tartományon kívüli értékeket azonban a rendszer elfogadja. Az érték eltolása Day 1-sel történik, és a számított hónap első napjára lesz alkalmazva. Más szóval a (Day - 1) a hónap első része lesz hozzáadva. A hónap és az év újraszámítása szükség esetén történik. Az alábbi eredmények ezt a hatást szemléltetik:
Ha Day 1, az eredmény a számított hónap első napja.
Ha Day 0, az eredmény az előző hónap utolsó napja.
Ha Day -1, az eredmény az előző hónap utolsó előtti napja.
Ha Day elmúlt az aktuális hónap vége, az eredmény a következő hónap megfelelő napja. Ha például Month 4 és Day 31, akkor az eredmény május 1.
Válaszok
A megadott évet, hónapot és napot jelképező érték, amely az időadatokat éjfélre (00:00:00) állítja be.
Példák
Ez a példa a függvény használatával DateSerial adja vissza a megadott év, hónap és nap dátumát.
' DateSerial returns the date for a specified year, month, and day.
Dim aDate As Date
' Variable aDate contains the date for February 12, 1969.
aDate = DateSerial(1969, 2, 12)
Console.WriteLine(aDate)
' The following example uses DateSerial to determine and display
' the last day of the previous month.
' First, establish a starting date.
Dim startDate = #1/23/1994#
' The 0 for the day represents the last day of the previous month.
Dim endOfLastMonth = DateSerial(startDate.Year, startDate.Month, 0)
Console.WriteLine("Last day in the previous month: " & endOfLastMonth)
' The following example finds and displays the day of the week that the
' 15th day of the following month will fall on.
Dim fifteenthsDay = DateSerial(Today.Year, Today.Month + 1, 15)
Console.WriteLine("The 15th of next month is a {0}", fifteenthsDay.DayOfWeek)
Megjegyzések
Az argumentum kétjegyű értékeit a rendszer a Year felhasználó által megadott számítógépbeállítások alapján értelmezi. Az alapértelmezett beállítások az, hogy a 0 és 29 közötti értékeket a 2000–2029 év, a 30 és 99 közötti értékeket pedig az 1930–1999 közötti évekként értelmezi a rendszer. Az összes többi év megjelöléséhez használjon négyjegyű évet, például 1924-et.
Az alábbi példa negatív, nulla és pozitív argumentumértékeket mutat be. Itt a függvény a DateSerial március első napját megelőző napot adja vissza Date az aktuális év 10 évvel korábbi évében, vagyis a tíz évvel ezelőtti február utolsó napját.
Dim EndFeb As Date = DateSerial(-10, 3, 0)
Ha vagy MonthDay meghaladja a normál tartományt, a rendszer a következő nagyobb egységre alkalmazza a megfelelő módon. Ha például 32 napot ad meg, akkor a kiértékelése egy hónap, egytől négy napig tart, az értéktől Monthfüggően. Ha Year nagyobb, mint 9999, vagy ha bármely argumentum a -2 147 483 648 és 2 147 483 647 közötti tartományon kívül esik, ArgumentException hiba történik. Ha a három argumentum által megadott dátum az 1. év január 1-jén 00:00:00-nál korábbi, vagy 9999. december 31-én 23:59:59-nél későbbi, ArgumentOutOfRangeException hiba történik.
Az Date adattípus időösszetevőket tartalmaz.
DateSerial ezeket 0 értékre állítja, így a visszaadott érték a számított nap kezdetét jelöli.
Mivel minden Date értéket egy DateTime struktúra támogat, a metódusok további lehetőségeket biztosítanak az Date értékek összeállításához. A túlterhelt DateTime konstruktorok egyikével például feltölthet egy változót Date az összetevők kívánt kombinációjával. Az alábbi példa 1978. május 6-ra állítja NewDateTime a hajnali 8:30 előtti egytized másodpercet:
Dim NewDateTime As Date = New Date(1978, 5, 6, 8, 29, 59, 900)
