1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
|
---
title: Date
slug: Web/JavaScript/Referencje/Obiekty/Date
tags:
- Date
- JavaScript
- data
translation_of: Web/JavaScript/Reference/Global_Objects/Date
---
<div>{{JSRef}}</div>
<h2 id="Podsumowanie" name="Podsumowanie">Podsumowanie</h2>
<p>Tworzy instancje <code>Date</code>, które pozwalają na pracę z danymi opisującymi datę i czas.</p>
<h2 id="Tworzony_przez" name="Tworzony_przez">Składnia</h2>
<pre class="syntaxbox"><code>new Date();
new Date(<em>milisekundy</em>);
new Date(<em>dateString</em>);
new Date(<em>rok</em>, <em>indeksMiesiąca </em>[, <em>dzień </em>[, <em>godzina </em>[, <em>minuta </em>[, <em>sekunda </em>[, <em>milisekunda</em>]]]]]);
</code></pre>
<h3 id="Parametry" name="Parametry">Parametry</h3>
<dl>
<dt><code>milisekundy</code> </dt>
<dd>Wartość całkowita reprezentująca liczbę milisekund od 1 stycznia 1970, godz. 00:00:00 UTC.</dd>
</dl>
<dl>
<dt><code>dateString</code> </dt>
<dd>Łańcuch znaków reprezentujący datę. Łańcuch znaków powinien być w formacie rozpoznawalnym przez metodę <a href="/pl/Dokumentacja_j%C4%99zyka_JavaScript_1.5/Obiekty/Date/parse" title="pl/Dokumentacja_języka_JavaScript_1.5/Obiekty/Date/parse">parse</a>.</dd>
</dl>
<dl>
<dt><code>rok</code></dt>
<dd>Wartość całkowita reprezentująca rok. Dla zgodności (w celu uniknięcia problemu roku 2000) należy zawsze określać rok w pełnej formie, używając raczej <code>1998</code> niż <code>98</code>.</dd>
</dl>
<dl>
<dt><code>indeksMiesiąca</code></dt>
<dd>Wartość całkowita reprezentująca miesiąc, począwszy od 0 dla stycznia, kończąc na 11 dla grudnia.</dd>
</dl>
<dl>
<dt><code>dzień</code></dt>
<dd>Wartość całkowita reprezentująca dzień miesiąca.</dd>
</dl>
<dl>
<dt><code>godzina</code></dt>
<dd>Wartość całkowita reprezentująca godzinę (w formacie 24-godzinnym).</dd>
</dl>
<dl>
<dt><code>minuta</code></dt>
<dd>Wartość całkowita reprezentująca część minutową odczytywanego czasu.</dd>
</dl>
<dl>
<dt><code>second</code></dt>
<dd>Wartość całkowita reprezentująca część sekundową odczytywanego czasu.</dd>
</dl>
<dl>
<dt><code>millisecond</code></dt>
<dd>Wartość całkowita reprezentująca część milisekundową odczytywanego czasu.</dd>
</dl>
<h2 id="Opis" name="Opis">Opis</h2>
<p>Jeśli nie dostarczasz żadnych argumentów, konstruktor tworzy obiekt <code>Date</code> dla dzisiejszej daty i czasu stosownie do czasu lokalnego. Jeśli dostarczasz jakieś argumenty, lecz nie wszystkie, brakujące argumenty mają ustawioną wartość 0. Jeśli jednak dostarczasz jakieś argumenty, musisz dostarczyć co najmniej rok, miesiąc i dzień. Pominąć możesz godzinę, minuty, sekundy i milisekundy.</p>
<p>Data jest mierzona w milisekundach od północy 1 stycznia 1970 UTC. W jednym dniu jest 86,400,000 milisekund. Zakres wartości obiektu <code>Date</code> wynosi od -100,000,000 dni do 100,000,000 dni w stosunku do 01 stycznia 1970 UTC.</p>
<p>Obiekt <code>Date</code> zapewnia jednolite działanie bez względu na platformę.</p>
<p>Obiekt <code>Date</code> wspiera wiele metod UTC (uniwersalny czas światowy) i metody czasu lokalnego. UTC, także znany jako <em>Greenwich Mean Time</em> (GMT), odnosi się do czasu ustanowionego przez "światowy standard czasu" (ang. World Time Standard). Czas lokalny jest czasem, który zna komputer, na jakim jest wykonywany JavaScript.</p>
<p>Dla kompatybilności z obliczeniami milenijnymi (inaczej, syndromem roku 2000), powinieneś zawsze określić pełen rok, czyli na przykład, używa 1998, nie 98. Aby pomóc Ci w określeniu całego roku, JavaScript zawiera metody {{jsxref("Date.prototype.getFullYear()")}}, {{jsxref("Date.prototype.setFullYear()")}}, {{jsxref("Date.getUTCFullYear()")}} i {{jsxref("Date.setUTCFullYear()")}}.</p>
<p>Odwoływanie się do <code>Date </code>w kontekście innym niż konstruktor (np. bez operatora {{jsxref("new")}}) będzie zwracało ciąg reprezentujący aktualny czas.</p>
<h2 id="W.C5.82asno.C5.9Bci" name="W.C5.82asno.C5.9Bci">Własności</h2>
<dl>
<dt>{{jsxref("Date.prototype")}}</dt>
<dd>Pozwala dodać własności do obiektu <code>Date</code>.</dd>
<dt><code>Date.length</code></dt>
<dd>The value of <code>Date.length</code> is 7. This is the number of arguments handled by the constructor.</dd>
<dt>
<div>{{jsOverrides("Function", "properties", "prototype")}}</div>
</dt>
</dl>
<h2 id="Metody_statyczne" name="Metody_statyczne">Metody</h2>
<dl>
<dt>{{jsxref("Date.now()")}}</dt>
<dd>Zwraca wartość liczbową odnoszącą się do aktualnego czasu.</dd>
<dt>{{jsxref("Date.parse()")}}</dt>
<dd>Zwraca liczbę milisekund, które upłynęły od 1 stycznia 1970, 00:00:00 czasu lokalnego do daty podanej jako argument string.</dd>
<dt>{{jsxref("Date.UTC()")}}</dt>
<dd>Zwraca liczbę milisekund, które upłynęły od 1 stycznia 1970, 00:00:00 czasu uniwersalnego do daty podanej jako zestaw liczb (parametry jak w najdłuższej formie konstruktora).</dd>
</dl>
<h2 id="Przykłady">Przykłady</h2>
<h3 id="Przyk.C5.82ad:_Kilka_sposob.C3.B3w_na_przypisywanie_dat" name="Przyk.C5.82ad:_Kilka_sposob.C3.B3w_na_przypisywanie_dat">Przykład: Kilka sposobów na przypisywanie dat</h3>
<p>Poniżej przedstawiono kilka przykładowych przypisań dat:</p>
<pre class="brush: js">var dzisiaj = new Date();
var urodziny = new Date("December 17, 1995 03:24:00");
var urodziny = new Date(1995,11,17);
var urodziny = new Date(1995,11,17,3,24,0);
</pre>
<h3 id="Przyk.C5.82ad:_Obliczanie_czasu_trwania" name="Przyk.C5.82ad:_Obliczanie_czasu_trwania">Przykład: Obliczanie czasu trwania</h3>
<p>Poniższy przykład pokazuje, jak określić czas, jaki minął pomiędzy dwoma datami:</p>
<pre class="brush: js">// używając metod statycznych
var start = Date.now();
// zdarzenie, dla którego chciałbyś zmierzyć czas trwania:
zrobCosPrzezDlugiCzas();
var stop = Date.now();
var roznica_czasow = stop - start; // czas w milisekundach
</pre>
<pre class="brush: js">// wykorzystując obiekty Date
var start = new Date();
// zdarzenie, dla którego chciałbyś zmierzyć czas trwania:
zrobCosPrzezDlugiCzas();
var stop = new Date();
var roznica_czasow = stop.getTime() - start.getTime(); // czas w milisekundach
</pre>
|
