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. |