Date – datový typ (Visual Basic)

Obsahuje hodnoty IEEE 64 (8 bajtů), které reprezentují data od 1. ledna do 31. prosince 9999 a časy od 12:00:00 (půlnoc) do 11:59:59.9999999 ODP. Každý přírůstek představuje 100 nanosekund, uplynulý čas od začátku 1. ledna v roce 1 v gregoriánském kalendáři. Maximální hodnota představuje 100 nanosekund před začátkem 1. ledna v roce 10000.

Poznámky

DateDatový typ použijte k zahrnutí hodnot data, času nebo hodnoty data a času.

Výchozí hodnota Date je 0:00:00 (půlnoc) od 1. ledna 0001.

Aktuální datum a čas můžete získat z DateAndTime třídy.

Požadavky na formát

Je nutné uzavřít Date literál v rámci znaménka čísla ( # # ). Je třeba zadat hodnotu data ve formátu M/d/rrrr, například #5/31/1993# nebo rrrr-mm-dd, například #1993-5-31# . Při prvním zadání roku můžete použít lomítka. Tento požadavek nezávisí na vašem národním prostředí a na nastavení formátu data a času vašeho počítače.

Důvodem tohoto omezení je, že význam vašeho kódu by se nikdy neměl měnit v závislosti na národním prostředí, ve kterém je vaše aplikace spuštěná. Předpokládejme, že máte pevně zavedený kód Date literálu #3/4/1998# a máte v úmyslu do 4. března 1998. V národním prostředí, které používá mm/dd/rrrr, se 3/4/1998 zkompiluje jako zamýšlená. Ale Předpokládejme, že nasadíte aplikaci v mnoha zemích nebo oblastech. V národním prostředí, které používá dd/mm/rrrr, je pevně zakódovaný literál zkompilován do 3. dubna 1998. V národním prostředí, které používá rrrr/mm/dd, bude literál neplatný (duben 1998, 0003) a způsobit chybu kompilátoru.

Alternativní řešení

Chcete-li převést Date literál na formát národního prostředí nebo na vlastní formát, zadejte do funkce literál a zadejte Format buď předdefinovaný nebo uživatelsky definovaný formát data. Následující příklad ukazuje to.

MsgBox("The formatted date is " & Format(#5/31/1993#, "dddd, d MMM yyyy"))

Alternativně můžete použít jeden z přetížených konstruktorů DateTime struktury k sestavení hodnoty data a času. Následující příklad vytvoří hodnotu, která představuje 31. května 1993 v 12:14 za odpoledne.

Dim dateInMay As New System.DateTime(1993, 5, 31, 12, 14, 0)

Formát hodiny

Hodnotu času můžete zadat buď v 12 hodinách, nebo ve 24hodinovém formátu, například #1:15:30 PM# nebo #13:15:30# . Pokud však nezadáte buď minuty, nebo sekundy, je nutné zadat dop nebo PM.

Výchozí hodnoty data a času

pokud nezahrnete datum do literálu data a času, Visual Basic nastaví část hodnoty data na 1. ledna 0001. pokud nezahrnete čas do literálu data a času, Visual Basic nastaví časovou část hodnoty na začátek dne, tj. půlnoc (0:00:00).

Převody typu

převedete-li Date hodnotu na String typ, Visual Basic vykreslí datum podle formátu krátkého data určeného národním prostředím runtime a vykreslí čas podle formátu času (12 hodin nebo 24 hodin) určeného národním prostředím runtime.

Tipy k programování

  • Problematika spolupráce. pokud procházejíte s komponentami, které nejsou napsané pro .NET Framework, například automatizace nebo objekty COM, pamatujte na to, že typy data a času v jiných prostředích nejsou kompatibilní s Date typem Visual Basic. pokud předáváte argument typu datum/čas pro takovou komponentu, deklarujte ji jako Double místo Date v novém Visual Basic kódu a použijte metody převodu DateTime.FromOADate a DateTime.ToOADate .

  • Znaky typu. Date nemá žádný znak typu literálu nebo znak typu identifikátoru. Nicméně kompilátor zpracovává literály, které jsou uzavřeny v symbolech čísla ( # # ) jako Date .

  • Typ rozhraní. odpovídající typ v .NET Framework je System.DateTime struktura.

Příklad

Proměnná nebo konstanta Date datového typu obsahuje datum i čas. Toto dokládá následující příklad.

Dim someDateAndTime As Date = #8/13/2002 12:14 PM#

Viz také