Date nesnesi bir tarih-saat zamanının oluşturulmasını ve o zamanın yılı, günü, saniyesi, milisaniyesi gibi özelliklerine erişilmesini ve kontrolünü sağlar.
- Date nesnesinin tanımlanması
- Date nesnesinin özellikleri ve metotları
Date Nesnesinin Tanımlanması (date.constructor)
Date nesnesi tanımlanırken, 1 saniyenin "1000" bin milisaniyeye eşit olduğu ve istemci bilgisayarında parametresiz olarak tanımlandığında istemci bilgisayarının tarih-saat değerlerini alacağı unutulmamalıdır.
Date nesnesi temel olarak aşağıdaki 4 şekilde oluşturulur:
- new Date()
- new Date(milisaniye)
- new Date(tarihmetni)
- new Date(yil, ay, gun [, saat, dakika, saniye, milisaniye] )
Parametreler
- milisaniye : 1 ocak 1970 tarihi saat 00:00:00'dan itibaren bugüne kadarki milisaniyeyi ifade eder.
- tarihmetni : kelime olarak tarihi ifade eder.
- yil, ay, gun : oluşturulacak tarihin bölümlerini tamsayı olarak belirler. ay değeri için "0" sıfır değeri ocak ayını, 11 değeri aralık ayını gösterir.
- saat, dakika, saniye, milisaniye : opsiyonel kullanılır. oluşturulacak tarihin bölümlerini tamsayı olarak belirler.
Parametrelerin Alabileceği Değerler
- yil : 1900'den sonraki bir yıl
- ay : 0..11 arası
- gun : 1..31 arası
- saat : 0..23 arası
- dakika : 0..59 arası
- saniye : 0..59 arası
- milisaniye : 0..999 arası
saat, dakika, saniye ve milisaniye belirtiminde tüm parametreler ayrı ayrı opsiyoneldir. Yani 3 veya 7 parametre gereklidir gibi bir kural yoktur. Fakat sadece sene belirtilerek oluşturmak istendiğinde date nesnesi bunu milisaniye olarak algılayacaktır. Bu yüzden, en az yil ve ay değerleri girilmelidir.
örnekler:
Date nesnesinin parametresiz oluşturulması
<html>
<head></head>
<body>
<script type="text/javascript">
var gunceltarih = new Date();
alert(gunceltarih);
</script>
</body>
</html>
Date nesnesinin milisaniye belirtilerek oluşturulması
| gün | saat | dakika | saniye | milisaniye |
| saniye | - | - | - | 1 | 1000 |
| dakika | - | - | 1 | 60 | 60.000 |
| saat | - | 1 | 60 | 3.600 | 3.600.000 |
| gün | 1 | 24 | 1440 | 86.400 | 86.400.000 |
<html>
<head></head>
<body>
<script type="text/javascript">
var mstarih = new Date(86400000); // 2 ocak 1970
alert( mstarih.tolocaledatestring() );
</script>
</body>
</html>
Date nesnesinin yıl, ay ve gün belirterek oluşturulması
<html>
<head></head>
<body>
<script type="text/javascript">
var gunceltarih = new Date(1980,0,5);
alert(gunceltarih.tolocaledatestring());
</script>
</body>
</html>
Date nesnesinin yıl, ay, gün, saat, dakika, saniye ve milisaniye belirterek oluşturulması
<html>
<head></head>
<body>
<script type="text/javascript">
var gunceltarih = new Date(1980,0,5,13,45,30,700);
alert(gunceltarih.tolocalestring());
</script>
</body>
</html>
Date Nesnesinin Özellikleri ve Metotları
Genel Metodlar ve Özellikler
| yöntem | açıklama |
|---|
| prototype | date nesnesine yeni özellikler ve metotlar eklemenizi sağlar. |
| constructor | date nesnesinin kurucu fonksiyonu. |
| tosource | tanımlanmış bir date nesnesini ifade eden nesne tanımı verir. yeni bir nesne oluşturmak için kullanılabilir. |
| valueof | date nesnesinin kök değerini verir. |
| parse | 1 ocak 1970 tarihinden sonraki bir tarih ifadesinin milisaniye olarak değerini döndürür. |
| utc | 1 ocak 1970 tarihinden sonraki üniversal bir tarih değerinin milisaniye olarak değerini döndürür. |
| tostring | tanımlanmış bir date nesnesinin string olarak gösterimini döndürür. |
| tolocalestring | belirli bir tarihi, yerel düzene uygun string tipine dönüştürür. |
| toutcstring | belirli bir tarihin üniversal zaman düzenine uygun gösterimini string cinsinden verir. |
| gettimezoneoffset | "0" sıfır zaman dilimi karşılığını dakika cinsinden verir. |
| togmtstring | belirli bir tarihi, internet gmt düzenine uygun string tipine dönüştürür. |
Tarih Değerlerini Almak
| yöntem | açıklama |
|---|
| tolocaledatestring | belirli bir tarihin sadece tarih kısmını yerel düzene uygun string tipinde verir. |
| todatestring | tanımlanmış bir date nesnesinin tarih bölümünü string cinsinden verir. |
| getfullyear | yerel zamana uygun belirtilmiş bir tarihteki tam seneyi verir. |
| getdate | yerel zamana uygun belirtilmiş bir tarihteki ayın gününü verir. |
| getmonth | yerel zamana uygun belirtilmiş bir tarihteki ayı verir. |
| getday | yerel zamana uygun belirtilmiş bir tarihteki haftanın gününü verir. |
| getyear | yerel zamana uygun belirtilmiş bir tarihteki 2 rakamlı seneyi verir. (kullanılmıyor) |
| getutcfullyear | üniversal zamana uygun belirtilmiş bir tarihteki tam seneyi verir. |
| getutcmonth | üniversal zamana uygun belirtilmiş bir tarihteki uygun ayı verir. |
| getutcdate | üniversal zamana uygun belirtilmiş bir tarihteki ayın gününü verir. |
| getutcday | üniversal zamana uygun belirtilmiş bir tarihteki haftanın gününü verir. |
Tarih Değerlerini Ayarlamak
| yöntem | açıklama |
|---|
| setfullyear | yerel zamana uygun belirtilmiş bir tarihteki tam seneyi ayarlar. |
| setdate | yerel zamana uygun belirtilmiş bir tarihteki ayın gününü ayarlar. |
| setmonth | yerel zamana uygun belirtilmiş bir tarihteki ayı ayarlar. |
| setyear | yerel zamana uygun belirtilmiş bir tarihteki 2 rakamlı seneyi ayarlar. (kullanılmıyor) |
| setutcdate | üniversal zamana uygun belirtilmiş bir tarihteki ayın gününü ayarlar. |
| setutcmonth | üniversal zamana uygun belirtilmiş bir tarihteki ayı ayarlar. |
| setutcfullyear | üniversal zamana uygun belirtilmiş bir tarihteki tam seneyi ayarlar. |
Saat Değerlerini Almak
| yöntem | açıklama |
|---|
| tolocaletimestring | belirli bir tarihin sadece saat kısmını yerel düzene uygun string tipinde verir. |
| totimestring | tanımlanmış bir date nesnesinin saat bölümünü string cinsinden verir. |
| gettime | yerel zamana uygun bir tarihin sayısal değerini verir.(farklı bir date nesnesine değer ataması yapmak için kullanılabilir.) |
| gethours | yerel zamana uygun belirtilmiş bir tarihteki saati verir. |
| getseconds | yerel zamana uygun belirtilmiş bir tarihteki dakikanın saniyesini verir. |
| getminutes | yerel zamana uygun belirtilmiş bir tarihteki saatin dakikasını verir. |
| getmilliseconds | yerel zamana uygun belirtilmiş bir tarihteki saniyenin milisaniyesini verir. |
| getutchours | üniversal zamana uygun belirtilmiş bir tarihteki saati verir. |
| getutcminutes | üniversal zamana uygun belirtilmiş bir tarihteki saatin dakikasını verir. |
| getutcseconds | üniversal zamana uygun belirtilmiş bir tarihteki dakikanın saniyesini verir. |
| getutcmilliseconds | üniversal zamana uygun belirtilmiş bir tarihteki saniyenin milisaniyesini verir. |
Saat Değerlerini Ayarlamak
| yöntem | açıklama |
|---|
| settime | yerel zamana uygun belirtilmiş bir tarihteki zamanı ayarlar. |
| setseconds | yerel zamana uygun belirtilmiş bir tarihteki saniyeyi ayarlar. |
| setminutes | yerel zamana uygun belirtilmiş bir tarihteki dakikayı ayarlar. |
| sethours | yerel zamana uygun belirtilmiş bir tarihteki saati ayarlar. |
| setmilliseconds | yerel zamana uygun belirtilmiş bir tarihteki milisaniyeyi ayarlar. |
| setutcmilliseconds | üniversal zamana uygun belirtilmiş bir tarihteki milisaniyeyi ayarlar. |
| setutcseconds | üniversal zamana uygun belirtilmiş bir tarihteki saniyeyi ayarlar. |
| setutcminutes | üniversal zamana uygun belirtilmiş bir tarihteki dakikayı ayarlar. |
| setutchours | üniversal zamana uygun belirtilmiş bir tarihteki saati ayarlar. |