Προηγούμενο θέμαΕπόμενο θέμα


Κλάση DateTimeSpan

Η στατική κλάση DateTimeSpan παρέχει λειτουργίες για τον καθορισμό του χρόνου που μεσολαβεί μεταξύ δύο στοιχείων ημερομηνίας ή ώρας και την προσθήκη ή αφαίρεση διαστήματος χρόνου. Παρέχει ένα σύνολο συναρτήσεων για εργασία με τη διαφορά μεταξύ δύο ημερομηνιών. Εφόσον τα διαστήματα ημερομηνιών αποτελούν απλά αριθμούς, η εφαρμογή μπορεί να χρησιμοποιήσει σε αυτά απλές μαθηματικές πράξεις: πολλαπλασιασμό, διαίρεση, προσθήκη, αφαίρεση και άλλες. Αυτή η κλάση είναι στατική. Η εφαρμογή δεν μπορεί να δημιουργήσει χρήσεις της κλάσης.

DateTimeSpan.addDate

Αυτή η συνάρτηση επιστρέφει μια νέα ημερομηνία η οποία αποτελεί το άθροισμα που προκύπτει από την προσθήκη δεδομένου αριθμού ετών, μηνών και ημερών στην ημερομηνία έναρξης. Οι μήνες μπορεί να είναι περισσότεροι από 12 και οι ημέρες περισσότερες από τον αριθμό ημερών ενός μήνα. Το τελικό αποτέλεσμα θα είναι το ίδιο με αυτό που θα προέκυπτε από τρεις διαφορετικές πράξεις. Προσθέστε πρώτα τα έτη. Στη συνέχεια, χρησιμοποιώντας την ημερομηνία που προκύπτει, προσθέστε τους μήνες. Στη συνέχεια, χρησιμοποιώντας την ημερομηνία που προκύπτει, προσθέστε τις ημέρες.

Κατά την προσθήκη ενός μήνα, η ημερομηνία που προκύπτει μπορεί να μην είναι έγκυρη. Για παράδειγμα, αν προσθέσετε ένα μήνα στην ημερομηνία Ιαν. 31 θα είχε ως αποτέλεσμα την μη έγκυρη ημερομηνία Φεβ. 31. Η συνάρτηση προσαρμόζει την ημερομηνία έτσι ώστε να είναι έγκυρη, σε αυτή την περίπτωση, αν το έτος δεν είναι δίσεκτο, τότε ο Φεβ. έχει 28 ημέρες και η ημερομηνία που προκύπτει θα είναι Μαρ. 3.

Οποιοδήποτε όρισμα years, months ή days μπορεί να είναι κενό ή να μην ορίζεται. Αν αυτό ισχύει, τότε η συγκεκριμένη τιμή θεωρείται ότι είναι μηδενική.

Οποιοδήποτε όρισμα years, months ή days μπορεί να είναι αρνητικό. Σε αυτή την περίπτωση, το αποτέλεσμα που προκύπτει είναι το ίδιο με αυτό που θα προέκυπτε εάν η μονάδα αφαιρούνταν από τη βασική ημερομηνία.

Σύνταξη

DateTimeSpan.addDate( startDate, years, months, days )

Ορίσματα

Επιστρέφει

Μια ημερομηνία η οποία προκύπτει από την προσθήκη των ετών, των μηνών και των ημερών στην ημερομηνία έναρξης.

Παράδειγμα

var startDate = date.parse( "2004-12-31" ); 
var endDate; 
endDate = DateTimeSpan( startDate, 1, 0, 0 ); // returns 2005-12-31 
endDate = DateTimeSpan( startDate, 0, 1, 0 ); // returns 2005-1-31 
endDate = DateTimeSpan( startDate, 0, 0, 1 ); // returns 2005-1-1 
endDate = DateTimeSpan( startDate, 1, 1, 1 ); // returns 2005-3-4 

Δείτε επίσης

Συνάρτηση DateTimeSpan.addTime

Συνάρτηση DateTimeSpan.subDate

DateTimeSpan.addTime

Αυτή η συνάρτηση επιστρέφει μια νέα ημερομηνία η οποία αποτελεί το άθροισμα που προκύπτει από την προσθήκη δεδομένου αριθμού ωρών, λεπτών και δευτερολέπτων στην ημερομηνία έναρξης. Οι ώρες μπορεί να είναι περισσότερες από 24 και τα λεπτά και τα δευτερόλεπτα περισσότερα από 60. Το τελικό αποτέλεσμα θα είναι το ίδιο με αυτό που θα προέκυπτε από τρεις διαφορετικές πράξεις: προσθέστε πρώτα τις ώρες. Στη συνέχεια, χρησιμοποιώντας την ημερομηνία που προκύπτει, προσθέστε τα λεπτά. Στη συνέχεια, χρησιμοποιώντας την ημερομηνία που προκύπτει, προσθέστε τα δευτερόλεπτα.

Οποιοδήποτε από τα ορίσματα hours, minutes και seconds μπορεί να είναι κενό ή να μην ορίζεται. Αν αυτό ισχύει, τότε η συγκεκριμένη τιμή θεωρείται ότι είναι μηδενική.

Οποιοδήποτε από τα ορίσματα hours, minutes και seconds μπορεί να μην ορίζεται. Σε αυτή την περίπτωση, το αποτέλεσμα που προκύπτει είναι το ίδιο με αυτό που θα προέκυπτε εάν η μονάδα αφαιρούνταν από τη βασική ημερομηνία.

Σύνταξη

DateTimeSpan.addTime( startDate, hours, minutes, seconds )

Ορίσματα

Επιστρέφει

Μια ημερομηνία η οποία προκύπτει από την προσθήκη των ωρών, των λεπτών και των δευτερολέπτων στην ημερομηνία έναρξης.

Δείτε επίσης

Συνάρτηση DateTimeSpan.addDate

Συνάρτηση DateTimeSpan.subTime

DateTimeSpan.days

Επιστρέφει τον αριθμό ημερών μεταξύ δύο ημερομηνιών. Μια ημέρα ορίζεται ως αλλαγή στο ημερολόγιο. Συνεπώς, από τις 11:59:59 μμ στις 27 Φεβ. μέχρι τα μεσάνυχτα στις 28 Φεβ. είναι μία μέρα, όπως επίσης από μεσάνυχτα στις 27 Φεβ. μέχρι τις 11:59:59 στις 28 Φεβ.

Σύνταξη

DateTimeSpan.days( startDate, endDate )

Ορίσματα

Επιστρέφει

Επιστρέφει τον αριθμό ημερών μεταξύ δύο ημερομηνιών.

DateTimeSpan.hours

Αυτή η συνάρτηση επιστρέφει τον αριθμό των πλήρων ωρών μεταξύ δύω ωρών. Μια πλήρης ώρα ορίζεται ως το διάστημα από ένα δεδομένο λεπτό της ώρας σε μία ώρα μέχρι το ίδιο λεπτό στην επόμενη ώρα. Για παράδειγμα, από τη 1:23:00 έως τις 2:23:00 είναι μία ώρα, ενώ από τη 1:23:00 έως τις 2:22:59 είναι μηδέν πλήρεις ώρες.

Σύνταξη

DateTimeSpan.hours( startDate, endDate )

Ορίσματα

Επιστρέφει

Ο αριθμός των πλήρων ωρών μεταξύ δύο ημερομηνιών.

DateTimeSpan.minutes

Αυτή η συνάρτηση επιστρέφει τον αριθμό των πλήρων λεπτών μεταξύ δύω ωρών. Ένα πλήρες λεπτό ορίζεται ως το διάστημα από ένα δεδομένο δευτερόλεπτο ενός λεπτού στο ίδιο δευτερόλεπτο στο επόμενο λεπτό. Για παράδειγμα, από τη 1:23:00 έως τη 1:24:00 είναι ένα λεπτό, ενώ από τη 1:23:00 έως τη 1:22:59 είναι μηδέν πλήρη λεπτά.

Σύνταξη

DateTimeSpan.minutes( startDate, endDate )

Ορίσματα

Επιστρέφει

Ο αριθμός των πλήρων λεπτών μεταξύ δύο ημερομηνιών.

DateTimeSpan.months

Αυτή η συνάρτηση επιστρέφει τον αριθμό των πλήρων μηνών μεταξύ δύο ημερομηνιών. Ένας πλήρης μήνας ορίζεται ως το χρονικό διάστημα από έναν αριθμό ημέρας του μήνα έως τον ίδιο αριθμό ημέρας του επόμενου μήνα. Για παράδειγμα, από τις 28 Φεβ. έως τις 28 Μαρ. είναι ένας πλήρης μήνας, ενώ από τις 28 Φεβ. έως τις 26 Μαρ. είναι μηδέν πλήρεις μήνες.

Σύνταξη

DateTimeSpan.months( startDate, endDate )

Ορίσματα

Επιστρέφει

Επιστρέφει τον αριθμό πλήρων μηνών μεταξύ δύο ημερομηνιών.

DateTimeSpan.seconds

Αυτή η συνάρτηση επιστρέφει τον αριθμό των δευτερολέπτων μεταξύ δύω ωρών.

Σύνταξη

DateTimeSpan.seconds( startDate, endDate )

Ορίσματα

Επιστρέφει

Ο αριθμός των πλήρων λεπτών μεταξύ δύο ημερομηνιών.

DateTimeSpan.subDate

Αυτή η συνάρτηση επιστρέφει μια νέα ημερομηνία η οποία αποτελεί το υπόλοιπο που προκύπτει από την αφαίρεση δεδομένου αριθμού ετών, μηνών και ημερών από την ημερομηνία έναρξης. Οι μήνες μπορεί να είναι περισσότεροι από 12 και οι ημέρες περισσότερες από τον αριθμό ημερών ενός μήνα. Το τελικό αποτέλεσμα θα είναι το ίδιο με αυτό που θα προέκυπτε από τρεις διαφορετικές πράξεις. Αφαιρέστε πρώτα τα έτη. Στη συνέχεια, χρησιμοποιώντας την ημερομηνία που προκύπτει, αφαιρέστε τους μήνες. Στη συνέχεια, χρησιμοποιώντας την ημερομηνία που προκύπτει, αφαιρέστε τις ημέρες.

Κατά την αφαίρεση ενός μήνα, η ημερομηνία που προκύπτει μπορεί να μην είναι έγκυρη. Για παράδειγμα, αν αφαιρέσετε ένα μήνα από τις 30 Μαρ. θα είχε ως αποτέλεσμα την μη έγκυρη ημερομηνία 31 Φεβ. Η συνάρτηση προσαρμόζει την ημερομηνία έτσι ώστε να είναι έγκυρη, προσαρμόζοντας την ημερομηνία στην τελευταία έγκυρη ημέρα του μήνα. Σε αυτή την περίπτωση, αν το έτος δεν είναι δίσεκτο, η ημερομηνία θα προσαρμοστεί στις 28 Φεβ.

Οποιοδήποτε όρισμα years, months ή days μπορεί να είναι κενό ή να μην ορίζεται. Σε αυτή την περίπτωση, η συγκεκριμένη τιμή θεωρείται ότι είναι μηδενική.

Οποιοδήποτε όρισμα years, months ή days μπορεί να είναι αρνητικό. Σε αυτή την περίπτωση, το αποτέλεσμα που προκύπτει είναι το ίδιο με αυτό που θα προέκυπτε εάν η μονάδα προσθετόταν στη βασική ημερομηνία.

Σύνταξη

DateTimeSpan.subDate( startDate, years, months, days )

Ορίσματα

Επιστρέφει

Μια ημερομηνία η οποία προκύπτει από την αφαίρεση των ετών, των μηνών και των ημερών από την ημερομηνία έναρξης.

Δείτε επίσης

Συνάρτηση DateTimeSpan.addDate

Συνάρτηση DateTimeSpan.subTime

DateTimeSpan.subTime

Αυτή η συνάρτηση επιστρέφει μια νέα ημερομηνία η οποία αποτελεί το αποτέλεσμα της αφαίρεσης δεδομένου αριθμού ωρών, λεπτών και δευτερολέπτων από την ημερομηνία έναρξης. Οι ώρες μπορεί να είναι περισσότερες από 24 και τα λεπτά και τα δευτερόλεπτα περισσότερα από 60. Το τελικό αποτέλεσμα θα είναι το ίδιο με αυτό που θα προέκυπτε από τρεις διαφορετικές πράξεις. Αφαιρέστε πρώτα τις ώρες. Στη συνέχεια, χρησιμοποιώντας την ημερομηνία που προκύπτει, αφαιρέστε τα λεπτά. Στη συνέχεια, χρησιμοποιώντας την ημερομηνία που προκύπτει, αφαιρέστε τα δευτερόλεπτα.

Οποιοδήποτε από τα ορίσματα hours, minutes και seconds μπορεί να είναι κενό ή να μην ορίζεται. Σε αυτή την περίπτωση, η συγκεκριμένη τιμή θεωρείται ότι είναι μηδενική.

Οποιοδήποτε από τα ορίσματα hours, minutes και seconds μπορεί να μην ορίζεται. Σε αυτή την περίπτωση, το αποτέλεσμα που προκύπτει είναι το ίδιο με αυτό που θα προέκυπτε εάν η μονάδα προσθετόταν στη βασική ημερομηνία.

Σύνταξη

DateTimeSpan.subTime( startDate, hours, minutes, seconds )

Ορίσματα

Επιστρέφει

Μια ημερομηνία η οποία προκύπτει από την αφαίρεση των ωρών, των λεπτών και των δευτερολέπτων από την ημερομηνία έναρξης.

Δείτε επίσης

Συνάρτηση DateTimeSpan.addTime

Συνάρτηση DateTimeSpan.subDate

DateTimeSpan.years

Αυτή η συνάρτηση υπολογίζει τον αριθμό των πλήρων ετών μεταξύ δύο ημερομηνιών. Ένα πλήρες έτος ορίζεται ότι διαρκεί από ένα δεδομένο μήνα, ημέρα, ώρα ενός έτους μέχρι τον ίδιο μήνα, ημέρα και ώρα του επόμενου έτους. Λόγω των δίσεκτων ετών, ένα πλήρες έτος μπορεί ορισμένες φορές να περιλαμβάνει 365 ημέρες και ορισμένες φορές 366 ημέρες.

Αν οποιοδήποτε όρισμα δεν αποτελεί ημερομηνία, προκύπτει εξαίρεση. Αν οποιοδήποτε όρισμα έχει τιμή "null", το αποτέλεσμα είναι επίσης "null".

Σύνταξη

DateTimeSpan.years( startDate, endDate )

Ορίσματα

Επιστρέφει

Ο αριθμός των πλήρων ετών μεταξύ των δύο ημερομηνιών.


(c) Copyright Actuate Corporation 2006

Προηγούμενο θέμαΕπόμενο θέμα