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

Κλάση BirtDateTime

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

BirtDateTime.addDay

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

Σύνταξη

Date BirtDateTime.addDay( ημερομηνία, n )

Παράμετροι

ημερομηνία

Αντικείμενο ημερομηνίας. Ένα αντικείμενο ημερομηνίας που αναπαριστά την ημερομηνία έναρξης.

n

Αντικείμενο αριθμού. Ο αριθμός των ημερών που θα προστεθούν στην ημερομηνία. Οι δεκαδικοί αριθμοί στρογγυλοποιούνται προς τα κάτω προς τον πλησιέστερο ακέραιο.

Επιστρέφει

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

Παραδείγματα

Το ακόλουθο παράδειγμα προσθέτει ημέρες σε μια συγκεκριμένη ημερομηνία:

var startDate = "2008-12-31";
var endDate;
endDate = BirtDateTime.addDay( startDate, 1 ); // επιστρέφει την τιμή Jan 01, 2009
endDate = BirtDateTime.addDay( startDate, -1 ); // επιστρέφει την τιμή Dec 30, 2008

Το ακόλουθο παράδειγμα προσθέτει 15 ημέρες σε κάθε τιμή ημερομηνίας που υπάρχει στο πεδίο InvoiceDate:

BirtDateTime.addDay( row["InvoiceDate"], 15 )

BirtDateTime.addHour

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

Σύνταξη

Date BirtDateTime.addHour( ημερομηνία, n )

Παράμετροι

ημερομηνία

Ένα αντικείμενο ημερομηνίας που αναπαριστά την ημερομηνία έναρξης. Αν μια ημερομηνία έναρξης δεν διαθέτει τιμή ώρας, η συνάρτηση θεωρεί ότι η ώρα είναι τα μεσάνυχτα (00:00:00).

n

Αντικείμενο αριθμού. Ο αριθμός των ωρών που θα προστεθούν στην ημερομηνία.

Επιστρέφει

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

Παραδείγματα

Το ακόλουθο παράδειγμα προσθέτει ώρες σε μια συγκεκριμένη ημερομηνία και ώρα:

var startDate = "2008-12-31 15:00:00";
var endDate;
endDate = BirtDateTime.addHour( startDate, 8 ); // επιστρέφει την τιμή Dec 31, 2008 11:00 PM
endDate = BirtDateTime.addHour( startDate, -8 ); // επιστρέφει την τιμή Dec 31, 2008 7:00 AM

Το ακόλουθο παράδειγμα προσθέτει 36 ώρες σε κάθε τιμή ημερομηνίας που υπάρχει στο πεδίο StartTime:

BirtDateTime.addHour( row["StartTime"], 36 )

BirtDateTime.addMinute

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

Σύνταξη

Date BirtDateTime.addMinute( ημερομηνία, n )

Παράμετροι

ημερομηνία

Ένα αντικείμενο ημερομηνίας που αναπαριστά την ημερομηνία έναρξης. Αν μια ημερομηνία έναρξης δεν διαθέτει τιμή ώρας, η συνάρτηση θεωρεί ότι η ώρα είναι τα μεσάνυχτα (00:00:00).

n

Αντικείμενο αριθμού. Ο αριθμός των λεπτών που θα προστεθούν στην ημερομηνία.

Επιστρέφει

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

Παραδείγματα

Το ακόλουθο παράδειγμα προσθέτει λεπτά σε μια συγκεκριμένη ημερομηνία και ώρα:

var startDate = "2008-12-31 10:30:00";
var endDate;
endDate = BirtDateTime.addMinute( startDate, 45 );
// επιστρέφει την τιμή Dec 31, 2008 11:15 AM
endDate = BirtDateTime.addMinute( startDate, -30 );
// επιστρέφει την τιμή Dec 31, 2008 10:00 AM

Το ακόλουθο παράδειγμα προσθέτει 15 λεπτά σε κάθε τιμή ημερομηνίας που υπάρχει στο πεδίο StartTime:

BirtDateTime.addMinute( row["StartTime"], 15 )

BirtDateTime.addMonth

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

Αυτή η συνάρτηση επιστρέφει πάντα μια έγκυρη ημερομηνία. Αν είναι απαραίτητο, το τμήμα των ημερών στην παραγόμενη ημερομηνία προσαρμόζεται προς τα κάτω στην τελευταία ημέρα του παραγόμενου μήνα του παραγόμενου έτους. Για παράδειγμα, αν προσθέσετε 1 μήνα στην ημερομηνία 31 Ιανουαρίου 2008, η συνάρτηση addM1onth( ) επιστρέφει την τιμή 29 Φεβρουαρίου 2008 (το 2008 είναι δίσεκτο έτος) και όχι 31 Φεβρουαρίου 2008.

Σύνταξη

Date BirtDateTime.addMonth( ημερομηνία, n )

Παράμετροι

ημερομηνία

Αντικείμενο ημερομηνίας. Ένα αντικείμενο ημερομηνίας που αναπαριστά την ημερομηνία έναρξης.

n

Αντικείμενο αριθμού. Ο αριθμός των μηνών που θα προστεθούν στην ημερομηνία. Οι δεκαδικοί αριθμοί στρογγυλοποιούνται προς τα κάτω προς τον πλησιέστερο ακέραιο.

Επιστρέφει

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

Παραδείγματα

Το ακόλουθο παράδειγμα προσθέτει μήνες σε μια συγκεκριμένη ημερομηνία:

var startDate = "2008-12-31";
var endDate;
endDate = BirtDateTime.addMonth( startDate, 1 ); // επιστρέφει την τιμή 31 Ιανουαρίου 2009
endDate = BirtDateTime.addMonth( startDate, -1 ); // επιστρέφει την τιμή Nov 30, 2008
endDate = BirtDateTime.addMonth( startDate, 2 ); // επιστρέφει την τιμή Feb 28, 2009

Το ακόλουθο παράδειγμα προσθέτει 10 μήνες σε κάθε τιμή ημερομηνίας που υπάρχει στο πεδίο InvoiceDate:

BirtDateTime.addMonth( row["InvoiceDate"], 10 )

BirtDateTime.addQuarter

Αυτή η συνάρτηση επιστρέφει μια νέα ημερομηνία η οποία προκύπτει από την πρόσθεση ενός δεδομένου αριθμού τριμήνων σε μια ημερομηνία. Το τρίμηνο ισούται με τρεις μήνες. Για παράδειγμα, αν προσθέσετε 2 τρίμηνα στην ημερομηνία 10 Σεπτεμβρίου 2008, η συνάρτηση θα επιστρέψει την ημερομηνία 10 Μαρτίου 2009. Ο αριθμός τριμήνων που θα προστεθεί μπορεί να είναι αρνητικός. Σε αυτή την περίπτωση, το αποτέλεσμα ισοδυναμεί με την αφαίρεση του αριθμού από την ημερομηνία.

Σύνταξη

Date BirtDateTime.addQuarter( ημερομηνία, n )

Παράμετροι

ημερομηνία

Ένα αντικείμενο ημερομηνίας που αναπαριστά την ημερομηνία έναρξης.

n

Αντικείμενο αριθμού. Ο αριθμός των τριμήνων που θα προστεθούν στην ημερομηνία.

Επιστρέφει

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

Παραδείγματα

Το ακόλουθο παράδειγμα προσθέτει τρίμηνα σε μια συγκεκριμένη ημερομηνία:

var startDate = "2008-12-15";
var endDate;
endDate = BirtDateTime.addQuarter( startDate, 1 ); // επιστρέφει την τιμή Mar 15, 2009
endDate = BirtDateTime.addQuarter( startDate, -2 ); // επιστρέφει την τιμή Jun 15, 2008

Το ακόλουθο παράδειγμα προσθέτει 2 τρίμηνα σε κάθε τιμή ημερομηνίας που υπάρχει στο πεδίο ForecastClosing:

BirtDateTime.addQuarter( row["ForecastClosing"], 2 )

BirtDateTime.addSecond

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

Σύνταξη

Date BirtDateTime.addSecond( ημερομηνία, n )

Παράμετροι

ημερομηνία

Ένα αντικείμενο ημερομηνίας που αναπαριστά την ημερομηνία έναρξης. Αν μια ημερομηνία έναρξης δεν διαθέτει τιμή ώρας, η συνάρτηση θεωρεί ότι η ώρα είναι τα μεσάνυχτα (00:00:00).

n

Αντικείμενο αριθμού. Ο αριθμός των δευτερολέπτων που θα προστεθούν στην ημερομηνία.

Επιστρέφει

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

Παραδείγματα

Το ακόλουθο παράδειγμα προσθέτει δευτερόλεπτα σε μια συγκεκριμένη ημερομηνία και ώρα:

var startDate = "2008-12-31 10:30:00";
var endDate;
endDate = BirtDateTime.addSecond( startDate, 10000 );
// επιστρέφει την τιμή Dec 31, 2008 1:16:40 PM
endDate = BirtDateTime.addSecond( startDate, -10000 );
// επιστρέφει την τιμή Dec 31, 2008 7:43:20 AM

Το ακόλουθο παράδειγμα προσθέτει 6000 δευτερόλεπτα σε κάθε τιμή ημερομηνίας που υπάρχει στο πεδίο StartTime:

BirtDateTime.addSecond( row["StartTime"], 6000 )

BirtDateTime.addWeek

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

Σύνταξη

Date BirtDateTime.addWeek( ημερομηνία, n )

Παράμετροι

ημερομηνία

Ένα αντικείμενο ημερομηνίας που αναπαριστά την ημερομηνία έναρξης.

n

Αντικείμενο αριθμού. Ο αριθμός των εβδομάδων που θα προστεθούν στην ημερομηνία.

Επιστρέφει

Αντικείμενο ημερομηνίας. Μια ημερομηνία που προκύπτει από την πρόσθεση του καθορισμένου αριθμού εβδομάδων στην ημερομηνία έναρξης.

Παραδείγματα

Το ακόλουθο παράδειγμα προσθέτει εβδομάδες σε μια συγκεκριμένη ημερομηνία:

var startDate = "2008-12-31";
var endDate;
endDate = BirtDateTime.addWeek( startDate, 1 ); // επιστρέφει την τιμή Jan 07, 2009
endDate = BirtDateTime.addWeek( startDate, -1 ); // επιστρέφει την τιμή Dec 24, 2008

Το ακόλουθο παράδειγμα προσθέτει 2 εβδομάδες σε κάθε τιμή ημερομηνίας που υπάρχει στο πεδίο InvoiceDate:

BirtDateTime.addWeek( row["InvoiceDate"], 2 )

BirtDateTime.addYear

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

Σύνταξη

Date BirtDateTime.addYear( ημερομηνία, n )

Παράμετροι

ημερομηνία

Ένα αντικείμενο ημερομηνίας που αναπαριστά την ημερομηνία έναρξης.

n

Αντικείμενο αριθμού. Ο αριθμός των ετών που θα προστεθούν στην ημερομηνία. Οι δεκαδικοί αριθμοί στρογγυλοποιούνται προς τα κάτω προς τον πλησιέστερο ακέραιο.

Επιστρέφει

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

Παραδείγματα

Το ακόλουθο παράδειγμα προσθέτει έτη σε μια συγκεκριμένη ημερομηνία:

var startDate = "2008-12-31";
var endDate;
endDate = BirtDateTime.addYear( startDate, 1 ); // επιστρέφει την τιμή Dec 31, 2009
endDate = BirtDateTime.addYear( startDate, -1 ); // επιστρέφει την τιμή Dec 31, 2007

Το ακόλουθο παράδειγμα προσθέτει 5 έτη σε κάθε τιμή ημερομηνίας που υπάρχει στο πεδίο HireDate:

BirtDateTime.addYear( row["HireDate"], 5 )

BirtDateTime.day

Αυτή η συνάρτηση επιστρέφει έναν αριθμό από το 1 έως το 31, ο οποίος αναπαριστά την ημέρα του μήνα για μια συγκεκριμένη ημερομηνία. Για παράδειγμα, αν η ημερομηνία είναι 2009-01-19, η συνάρτηση επιστρέφει την τιμή 19.

Σύνταξη

integer BirtDateTime.day( ημερομηνία )

Παράμετρος

ημερομηνία

Αντικείμενο ημερομηνίας. Ένα αντικείμενο ημερομηνίας από το οποίο θα ανακτηθεί η ημέρα του μήνα.

Επιστρέφει

Έναν ακέραιο αριθμό που αναπαριστά την ημέρα του μήνα για μια συγκεκριμένη ημερομηνία.

Παραδείγματα

Το ακόλουθο παράδειγμα επιστρέφει την ημέρα του μήνα για κάθε τιμή που υπάρχει στο πεδίο ShipDate:

BirtDateTime.day( row["ShipDate"] )

Το ακόλουθο παράδειγμα επιστρέφει την ημέρα του μήνα για την τρέχουσα ημερομηνία:

BirtDateTime.day( (BirtDateTime.today())

BirtDateTime.diffDay

Αυτή η συνάρτηση επιστρέφει το πλήθος των ημερών μεταξύ δύο ημερομηνιών. Η ημέρα υπολογίζεται αφαιρώντας την τιμή ημέρας της πρώτης ημερομηνίας από την τιμή ημέρας της δεύτερης ημερομηνίας. Για παράδειγμα, αν η πρώτη ημερομηνία είναι 2008-12-30 23:59:59 και η δεύτερη ημερομηνία είναι 2008-12-31 00:00:00, η συνάρτηση επιστρέφει 1 ημέρα, παρόλο που τις δύο ημερομηνίες χωρίζει μόλις ένα δευτερόλεπτο.

Σύνταξη

integer BirtDateTime.diffDay( ημερομηνία1, ημερομηνία2 )

Παράμετροι

ημερομηνία1

Ένα αντικείμενο ημερομηνίας που αναπαριστά την αρχή του χρονικού εύρους.

ημερομηνία2

Ένα αντικείμενο ημερομηνίας που αναπαριστά το τέλος του χρονικού εύρους.

Επιστρέφει

Ακέραιος. Το πλήθος ημερών μεταξύ δύο ημερομηνιών.

Παραδείγματα

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των ημερών μεταξύ συγκεκριμένων ημερομηνιών:

BirtDateTime.diffDay( "2009-01-01", "2009-04-15" ) // επιστρέφει την τιμή 104

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των ημερών μεταξύ της τρέχουσας ημερομηνίας και του τέλους του 2009:

BirtDateTime.diffDay( BirtDateTime.today(), "2009-12-31" )

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των ημερών μεταξύ των τιμών των πεδίων InvoiceDate και PaymentDate:

BirtDateTime.diffDay( row["InvoiceDate"], row["PaymentDate"] )

BirtDateTime.diffHour

Αυτή η συνάρτηση επιστρέφει το πλήθος των ωρών μεταξύ δύο ημερομηνιών. Η ώρα υπολογίζεται αφαιρώντας την τιμή ώρας της πρώτης ημερομηνίας από την τιμή ώρας της δεύτερης ημερομηνίας. Για παράδειγμα, αν η πρώτη ημερομηνία είναι 2009-01-31 1:30:00 και η δεύτερη ημερομηνία είναι 2009-01-31 2:00:00, η συνάρτηση επιστρέφει 1 ώρα, παρόλο που τις δύο ημερομηνίες χωρίζουν μόλις 30 λεπτά. Αν μια ημερομηνία δεν διαθέτει τιμή ώρας, η συνάρτηση θεωρεί ότι η ώρα είναι τα μεσάνυχτα (00:00:00).

Σύνταξη

integer BirtDateTime.diffHour( ημερομηνία1, ημερομηνία2 )

Παράμετροι

ημερομηνία1

Ένα αντικείμενο ημερομηνίας που αναπαριστά την αρχή του χρονικού εύρους.

ημερομηνία2

Ένα αντικείμενο ημερομηνίας που αναπαριστά το τέλος του χρονικού εύρους.

Επιστρέφει

Ακέραιος. Το πλήθος ωρών μεταξύ δύο ημερομηνιών.

Παραδείγματα

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των ωρών μεταξύ συγκεκριμένων ημερομηνιών:

BirtDateTime.diffHour( "2009-01-31 12:00:00", "2009-02-01 12:00:00")
// επιστρέφει την τιμή 24
BirtDateTime.diffHour( "2009-01-31", "2009-02-01 12:00:00")
// επιστρέφει την τιμή 36. Η πρώτη ημερομηνία δεν διαθέτει ώρα, συνεπώς χρησιμοποιείται η τιμή 00:00:00.

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των ωρών μεταξύ της τρέχουσας ημερομηνίας και ώρας και του τέλους του 2009:

BirtDateTime.diffHour( BirtDateTime.now(), "2009-12-31" );

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των ωρών μεταξύ των τιμών των πεδίων StartTime και FinishTime:

BirtDateTime.diffHour( row["StartTime"], row["FinishTime"] )

BirtDateTime.diffMinute

Αυτή η συνάρτηση επιστρέφει το πλήθος των λεπτών μεταξύ δύο ημερομηνιών. Το λεπτό υπολογίζεται αφαιρώντας την τιμή λεπτού της πρώτης ημερομηνίας από την τιμή λεπτού της δεύτερης ημερομηνίας. Για παράδειγμα, αν η πρώτη ημερομηνία είναι 2009-01-31 1:30:59 και η δεύτερη ημερομηνία είναι 2009-01-31 1:31:00, η συνάρτηση επιστρέφει 1 λεπτό, παρόλο που τις δύο ημερομηνίες χωρίζει μόλις ένα δευτερόλεπτο. Αν μια ημερομηνία δεν διαθέτει τιμή ώρας, η συνάρτηση θεωρεί ότι η ώρα είναι τα μεσάνυχτα (00:00:00).

Σύνταξη

integer BirtDateTime.diffMinute( ημερομηνία1, ημερομηνία2 )

Παράμετροι

ημερομηνία1

Ένα αντικείμενο ημερομηνίας που αναπαριστά την αρχή του χρονικού εύρους.

ημερομηνία2

Ένα αντικείμενο ημερομηνίας που αναπαριστά το τέλος του χρονικού εύρους.

Επιστρέφει

Ακέραιος. Το πλήθος λεπτών μεταξύ δύο ημερομηνιών.

Παραδείγματα

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των λεπτών μεταξύ συγκεκριμένων ημερομηνιών:

BirtDateTime.diffMinute( "2009-01-31 1:30:30", "2009-01-31 10:45:00")
// επιστρέφει την τιμή 555
BirtDateTime.diffMinute( "2009-01-31", "2009-01-31 12:00:00")
// επιστρέφει την τιμή 720. Η πρώτη ημερομηνία δεν διαθέτει ώρα, συνεπώς χρησιμοποιείται η τιμή 00:00:00.

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των λεπτών μεταξύ της τρέχουσας ημερομηνίας και ώρας και της αρχής του 2010:

BirtDateTime.diffMinute( BirtDateTime.now(), "2010-01-01" )

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των λεπτών μεταξύ των τιμών των πεδίων StartTime και FinishTime:

BirtDateTime.diffMinute( row["StartTime"], row["FinishTime"] )

BirtDateTime.diffMonth

Αυτή η συνάρτηση επιστρέφει τον αριθμό των μηνών μεταξύ δύο ημερομηνιών. Ο μήνας υπολογίζεται αφαιρώντας την τιμή μήνα της πρώτης ημερομηνίας από την τιμή μήνα της δεύτερης ημερομηνίας. Για παράδειγμα, αν η πρώτη ημερομηνία είναι 2009-01-31 και η δεύτερη ημερομηνία είναι 2009-02-01, η συνάρτηση επιστρέφει 1 μήνα, παρόλο που τις δύο ημερομηνίες χωρίζει μόλις μία ημέρα.

Σύνταξη

integer BirtDateTime.diffMonth( ημερομηνία1, ημερομηνία2 )

Παράμετροι

ημερομηνία1

Ένα αντικείμενο ημερομηνίας που αναπαριστά την αρχή του χρονικού εύρους.

ημερομηνία2

Ένα αντικείμενο ημερομηνίας που αναπαριστά το τέλος του χρονικού εύρους.

Επιστρέφει

Ακέραιος. Το πλήθος μηνών μεταξύ δύο ημερομηνιών.

Παραδείγματα

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των μηνών μεταξύ συγκεκριμένων ημερομηνιών:

BirtDateTime.diffMonth( "2009-01-31", "2009-04-15") // επιστρέφει την τιμή 3

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των μηνών μεταξύ της τρέχουσας ημερομηνίας και της αρχής του 2010:

BirtDateTime.diffMonth( BirtDateTime.today(), "2010-01-01" );

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των μηνών μεταξύ των τιμών των πεδίων ProjectStart και ProjectComplete:

BirtDateTime.diffMonth( row["ProjectStart"], row["ProjectComplete"] )

BirtDateTime.diffQuarter

Αυτή η συνάρτηση επιστρέφει το πλήθος των τριμήνων μεταξύ δύο ημερομηνιών. Το τρίμηνο υπολογίζεται αφαιρώντας την τιμή μήνα της πρώτης ημερομηνίας από την τιμή μήνα της δεύτερης ημερομηνίας. Μια διαφορά 3 μηνών ισούται με ένα τρίμηνο. Για παράδειγμα, αν η πρώτη ημερομηνία είναι 2009-01-31 και η δεύτερη ημερομηνία είναι 2009-07-01, η συνάρτηση επιστρέφει την τιμή 2. Αν η πρώτη ημερομηνία είναι 2009-01-01 και η δεύτερη ημερομηνία είναι 2009-09-30 η συνάρτηση επιστρέφει και πάλι την τιμή 2.

Σύνταξη

integer BirtDateTime.diffQuarter( ημερομηνία1, ημερομηνία2 )

Παράμετροι

ημερομηνία1

Ένα αντικείμενο ημερομηνίας που αναπαριστά την αρχή του χρονικού εύρους.

ημερομηνία2

Ένα αντικείμενο ημερομηνίας που αναπαριστά το τέλος του χρονικού εύρους.

Επιστρέφει

Ακέραιος. Το πλήθος τριμήνων μεταξύ δύο ημερομηνιών.

Παραδείγματα

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των τριμήνων μεταξύ συγκεκριμένων ημερομηνιών:

BirtDateTime.diffQuarter( "2009-01-31", "2009-04-15") // επιστρέφει την τιμή 1

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των τριμήνων μεταξύ της τρέχουσας ημερομηνίας και της αρχής του 2010:

BirtDateTime.diffQuarter( BirtDateTime.today(), "2010-01-01" );

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των τριμήνων μεταξύ των τιμών των πεδίων ProjectStart και ProjectComplete:

BirtDateTime.diffQuarter( row["ProjectStart"], row["ProjectComplete"] )

BirtDateTime.diffSecond

Αυτή η συνάρτηση επιστρέφει το πλήθος των δευτερολέπτων μεταξύ δύο ημερομηνιών. Αν μια ημερομηνία δεν διαθέτει τιμή ώρας, η συνάρτηση θεωρεί ότι η ώρα είναι τα μεσάνυχτα (00:00:00).

Σύνταξη

integer BirtDateTime.diffSecond( ημερομηνία1, ημερομηνία2 )

Παράμετροι

ημερομηνία1

Ένα αντικείμενο ημερομηνίας που αναπαριστά την αρχή του χρονικού εύρους.

ημερομηνία2

Ένα αντικείμενο ημερομηνίας που αναπαριστά το τέλος του χρονικού εύρους.

Επιστρέφει

Ακέραιος. Το πλήθος δευτερολέπτων μεταξύ δύο ημερομηνιών.

Παραδείγματα

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των δευτερολέπτων μεταξύ συγκεκριμένων ημερομηνιών:

BirtDateTime.diffSecond( "2009-01-31 11:30:30", "2009-01-31 12:00:00")
// επιστρέφει την τιμή 1770
BirtDateTime.diffSecond( "2009-01-31", "2009-01-31 1:00:00")
// επιστρέφει την τιμή 3600. Η πρώτη ημερομηνία δεν διαθέτει ώρα, συνεπώς χρησιμοποιείται η τιμή 00:00:00.

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των δευτερολέπτων μεταξύ της τρέχουσας ημερομηνίας και ώρας και της αρχής του 2010:

BirtDateTime.diffSecond( BirtDateTime.now(), "2010-01-01" )

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των δευτερολέπτων μεταξύ των τιμών των πεδίων StartTime και FinishTime:

BirtDateTime.diffSecond( row["StartTime"], row["FinishTime"] )

BirtDateTime.diffWeek

Αυτή η συνάρτηση επιστρέφει το πλήθος των εβδομάδων μεταξύ δύο ημερομηνιών. Η εβδομάδα υπολογίζεται αφαιρώντας τον αριθμό εβδομάδας της πρώτης ημερομηνίας από τον αριθμό εβδομάδας της δεύτερης ημερομηνίας. Για παράδειγμα, αν η πρώτη ημερομηνία είναι 2009-01-02 (εβδομάδα 1 του έτους) και η δεύτερη ημερομηνία είναι 2009-01-05 (εβδομάδα 2 του έτους), η συνάρτηση επιστρέφει την τιμή 1 εβδομάδα, παρόλο που τις δύο ημερομηνίες χωρίζουν μόλις τρεις ημέρες.

Σύνταξη

integer BirtDateTime.diffWeek( ημερομηνία1, ημερομηνία2 )

Παράμετροι

ημερομηνία1

Ένα αντικείμενο ημερομηνίας που αναπαριστά την αρχή του χρονικού εύρους.

ημερομηνία2

Ένα αντικείμενο ημερομηνίας που αναπαριστά το τέλος του χρονικού εύρους.

Επιστρέφει

Ακέραιος. Το πλήθος εβδομάδων μεταξύ δύο ημερομηνιών.

Παραδείγματα

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των εβδομάδων μεταξύ συγκεκριμένων ημερομηνιών:

BirtDateTime.diffWeek( "2009-01-01", "2009-02-01") // επιστρέφει την τιμή 5

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των εβδομάδων μεταξύ της τρέχουσας ημερομηνίας και της αρχής του 2010:

BirtDateTime.diffWeek( BirtDateTime.today(), "2010-01-01" );

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των εβδομάδων μεταξύ των τιμών των πεδίων ProjectStart και ProjectComplete:

BirtDateTime.diffWeek( row["ProjectStart"], row["ProjectComplete"] )

BirtDateTime.diffYear

Αυτή η συνάρτηση επιστρέφει το πλήθος των ετών μεταξύ δύο ημερομηνιών. Το έτος υπολογίζεται αφαιρώντας την τιμή έτους της πρώτης ημερομηνίας από την τιμή έτους της δεύτερης ημερομηνίας. Για παράδειγμα, αν η πρώτη ημερομηνία είναι 2009-01-01 και η δεύτερη ημερομηνία είναι 2009-12-31, η συνάρτηση επιστρέφει την τιμή 0. Αν η πρώτη ημερομηνία είναι 2008-11-15 και η δεύτερη ημερομηνία είναι 2009-01-15, η συνάρτηση επιστρέφει την τιμή 1.

Σύνταξη

integer BirtDateTime.diffYear( ημερομηνία1, ημερομηνία2 )

Παράμετροι

ημερομηνία1

Ένα αντικείμενο ημερομηνίας που αναπαριστά την αρχή του χρονικού εύρους.

ημερομηνία2

Ένα αντικείμενο ημερομηνίας που αναπαριστά το τέλος του χρονικού εύρους.

Επιστρέφει

Ακέραιος. Το πλήθος ετών μεταξύ δύο ημερομηνιών.

Παραδείγματα

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των ετών μεταξύ συγκεκριμένων ημερομηνιών:

BirtDateTime.diffYear( "2005-01-01", "2009-06-01") // επιστρέφει την τιμή 4

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των ετών μεταξύ των τιμών του πεδίου HireDate και της τρέχουσας ημερομηνίας:

BirtDateTime.diffYear( row["HireDate"], BirtDateTime.today() )

BirtDateTime.diffYear

Αυτή η συνάρτηση επιστρέφει το πλήθος των ετών μεταξύ δύο ημερομηνιών. Το έτος υπολογίζεται αφαιρώντας την τιμή έτους της πρώτης ημερομηνίας από την τιμή έτους της δεύτερης ημερομηνίας. Για παράδειγμα, αν η πρώτη ημερομηνία είναι 2009-01-01 και η δεύτερη ημερομηνία είναι 2009-12-31, η συνάρτηση επιστρέφει την τιμή 0. Αν η πρώτη ημερομηνία είναι 2008-11-15 και η δεύτερη ημερομηνία είναι 2009-01-15, η συνάρτηση επιστρέφει την τιμή 1.

Σύνταξη

integer BirtDateTime.diffYear( ημερομηνία1, ημερομηνία2 )

Παράμετροι

ημερομηνία1

Ένα αντικείμενο ημερομηνίας που αναπαριστά την αρχή του χρονικού εύρους.

ημερομηνία2

Ένα αντικείμενο ημερομηνίας που αναπαριστά το τέλος του χρονικού εύρους.

Επιστρέφει

Ακέραιος. Το πλήθος ετών μεταξύ δύο ημερομηνιών.

Παραδείγματα

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των ετών μεταξύ συγκεκριμένων ημερομηνιών:

BirtDateTime.diffYear( "2005-01-01", "2009-06-01") // επιστρέφει την τιμή 4

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των ετών μεταξύ των τιμών του πεδίου HireDate και της τρέχουσας ημερομηνίας:

BirtDateTime.diffYear( row["HireDate"], BirtDateTime.today() )

BirtDateTime.firstDayOfMonth

Αυτή η συνάρτηση επιστρέφει την ημερομηνία της πρώτης ημέρας του μήνα στον οποίο βρίσκεται η ημερομηνία εισόδου.

Σύνταξη

Date BirtDateTime.firstDayOfMonth( ημερομηνία )

Παράμετροι

ημερομηνία

Ένα αντικείμενο ημερομηνίας από το οποίο θα ανακτηθεί ο μήνας.

Επιστρέφει

Αντικείμενο ημερομηνίας. Η πρώτη ημέρα του μήνα για μια συγκεκριμένη ημερομηνία.

Παραδείγματα

Το ακόλουθο παράδειγμα παρουσιάζει τις τιμές μήνα που επιστρέφονται για μια συγκεκριμένη ημερομηνία:

BirtDateTime.firstDayOfMonth( "2009-02-15" ) // επιστρέφει την τιμή 2009-02-01

BirtDateTime.firstDayOfQuarter

Αυτή η συνάρτηση επιστρέφει την ημερομηνία της πρώτης ημέρας του τριμήνου στο οποίο βρίσκεται η ημερομηνία εισόδου.

Σύνταξη

Date BirtDateTime.firstDayOfQuarter( ημερομηνία )

Παράμετροι

ημερομηνία

Ένα αντικείμενο ημερομηνίας από το οποίο θα ανακτηθεί το τρίμηνο.

Επιστρέφει

Αντικείμενο ημερομηνίας. Η πρώτη ημέρα του τριμήνου μια συγκεκριμένη ημερομηνία.

Παραδείγματα

Το ακόλουθο παράδειγμα παρουσιάζει τις τιμές τριμήνου που επιστρέφονται για μια συγκεκριμένη ημερομηνία:

BirtDateTime.firstDayOfQuarter( "2009-02-15" ) // επιστρέφει την τιμή 2009-01-01

BirtDateTime.firstDayOfWeek

Αυτή η συνάρτηση επιστρέφει την ημερομηνία της πρώτης ημέρας της εβδομάδας στην οποία βρίσκεται η ημερομηνία εισόδου.

Σύνταξη

Date BirtDateTime.firstDayOfWeek( ημερομηνία )

Παράμετροι

ημερομηνία

Ένα αντικείμενο ημερομηνίας από το οποίο θα ανακτηθεί η εβδομάδα.

Επιστρέφει

Αντικείμενο ημερομηνίας. Η πρώτη ημέρα της εβδομάδας για μια συγκεκριμένη ημερομηνία.

Παραδείγματα

Το ακόλουθο παράδειγμα παρουσιάζει τις τιμές εβδομάδας που επιστρέφονται για μια συγκεκριμένη ημερομηνία:

BirtDateTime.firstDayOfWeek( "2009-02-15" ) // επιστρέφει την τιμή 2009-02-15

BirtDateTime.firstDayOfYear

Αυτή η συνάρτηση επιστρέφει την ημερομηνία της πρώτης ημέρας του έτους στο οποίο βρίσκεται η ημερομηνία εισόδου.

Σύνταξη

Date BirtDateTime.firstDayOfYear( ημερομηνία )

Παράμετροι

ημερομηνία

Ένα αντικείμενο ημερομηνίας από το οποίο θα ανακτηθεί το έτος.

Επιστρέφει

Αντικείμενο ημερομηνίας. Η πρώτη ημέρα του έτους για μια συγκεκριμένη ημερομηνία.

Παραδείγματα

Το ακόλουθο παράδειγμα παρουσιάζει τις τιμές έτους που επιστρέφονται για μια συγκεκριμένη ημερομηνία:

BirtDateTime.firstDayOfYear( "2009-02-15" ) // επιστρέφει την τιμή 2009-01-01

BirtDateTime.month

Αυτή η συνάρτηση επιστρέφει το μήνα μιας συγκεκριμένης ημερομηνίας. Ανάλογα με την επιλογή σας, η συνάρτηση επιστρέφει το μήνα ως αριθμό, το πλήρες όνομα μήνα ή το σύντομο όνομα μήνα. Το όνομα του μήνα εξαρτάται από τις τοπικές ρυθμίσεις.

Σύνταξη

string BirtDateTime.month( ημερομηνία, επιλογή )

Παράμετροι

ημερομηνία

Ένα αντικείμενο ημερομηνίας από το οποίο θα ανακτηθεί ο μήνας.

επιλογή

Ακέραιος. Προαιρετική. Ένας αριθμός που αναπαριστά τη μορφή του μήνα που θα επιστραφεί. Χρησιμοποιήστε μία από τις ακόλουθες τιμές:

*
*
*

Αν παραλείψετε αυτό το όρισμα, η συνάρτηση επιστρέφει το μήνα με μορφή αριθμού.

Επιστρέφει

Σειρά χαρακτήρων. Ο μήνας για μια συγκεκριμένη ημερομηνία.

Παραδείγματα

Το ακόλουθο παράδειγμα παρουσιάζει τις τιμές μήνα που επιστρέφονται για μια συγκεκριμένη ημερομηνία:

BirtDateTime.month( "2009-02-15" ) // επιστρέφει την τιμή 2
BirtDateTime.month( "2009-02-15", 2 ) // επιστρέφει την τιμή Φεβρουάριος
BirtDateTime.month( "2009-02-15", 3) // επιστρέφει την τιμή Φεβ

Το ακόλουθο παράδειγμα επιστρέφει το μήνα της τρέχουσας ημερομηνίας:

BirtDateTime.month( (BirtDateTime.today() )

BirtDateTime.now

Αυτή η συνάρτηση επιστρέφει την τρέχουσα ημερομηνία και ώρα, για παράδειγμα Feb 2, 2009 2:05 PM.

Σύνταξη

Date BirtDateTime.now( )

Επιστρέφει

Αντικείμενο ημερομηνίας. Η τρέχουσα ημερομηνία και ώρα.

Παράδειγμα

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των ωρών μεταξύ της τρέχουσας ημερομηνίας και ώρας και των Χριστουγέννων:

BirtDateTime.diffHour( BirtDateTime.now(), "2009-12-25" )

BirtDateTime.quarter

Αυτή η συνάρτηση επιστρέφει έναν αριθμό από το 1 έως το 4, ο οποίος αναπαριστά το τρίμηνο στο οποίο βρίσκεται μια συγκεκριμένη ημερομηνία. Το πρώτο τρίμηνο ξεκινά την 1η Ιανουαρίου.

Σύνταξη

integer BirtDateTime.quarter( ημερομηνία )

Παράμετρος

ημερομηνία

Ένα αντικείμενο ημερομηνίας από το οποίο θα ανακτηθεί ο αριθμός του τριμήνου.

Επιστρέφει

Ακέραιος. Ο αριθμός του τριμήνου για μια συγκεκριμένη ημερομηνία.

Παραδείγματα

Το ακόλουθο παράδειγμα παρουσιάζει τους αριθμούς τριμήνου που επιστρέφονται για συγκεκριμένες ημερομηνίες:

BirtDateTime.quarter( "2009-02-15" ) // επιστρέφει την τιμή 1
BirtDateTime.quarter( "2009-07-10" ) // επιστρέφει την τιμή 3

Το ακόλουθο παράδειγμα επιστρέφει τον αριθμό τριμήνου για κάθε τιμή που υπάρχει στο πεδίο CloseDate:

BirtDateTime.quarter( row["CloseDate"] )

Το ακόλουθο παράδειγμα επιστρέφει τον αριθμό τριμήνου της τρέχουσας ημερομηνίας:

BirtDateTime.quarter( (BirtDateTime.today() )

BirtDateTime.today

Αυτή η συνάρτηση επιστρέφει την τρέχουσα ημερομηνία με τιμή ώρας τα μεσάνυχτα, για παράδειγμα 2 Φεβρουαρίου 2009 12:00 ΠΜ.

Σύνταξη

Date BirtDateTime.today( )

Επιστρέφει

Αντικείμενο ημερομηνίας. Η τρέχουσα ημερομηνία με τιμή ώρας τα μεσάνυχτα.

Παραδείγματα

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των ημερών μεταξύ της τρέχουσας ημερομηνίας και των Χριστουγέννων:

BirtDateTime.diffDay( BirtDateTime.today(), "2009-12-25" )

Το ακόλουθο παράδειγμα επιστρέφει το πλήθος των ετών μεταξύ των τιμών του πεδίου HireDate και της τρέχουσας ημερομηνίας.

BirtDateTime.diffYear( [HireDate], BirtDateTime.today() )

BirtDateTime.week

Αυτή η συνάρτηση επιστρέφει έναν αριθμό από το 1 έως το 52, ο οποίος αναπαριστά την εβδομάδα μιας συγκεκριμένης ημερομηνίας.

Σύνταξη

integer BirtDateTime.week( ημερομηνία )

Παράμετρος

ημερομηνία

Ένα αντικείμενο ημερομηνίας από το οποίο θα ανακτηθεί ο αριθμός της εβδομάδας.

Επιστρέφει

Ακέραιος. Ο αριθμός της εβδομάδας για μια συγκεκριμένη ημερομηνία.

Παραδείγματα

Το ακόλουθο παράδειγμα παρουσιάζειι τους αριθμούς εβδομάδας που επιστρέφονται για συγκεκριμένες ημερομηνίες:

BirtDateTime.week( "2009-02-15" ) // επιστρέφει την τιμή 8
BirtDateTime.week( "2009-10-12" ) // επιστρέφει την τιμή 42

Το ακόλουθο παράδειγμα επιστρέφει τον αριθμό εβδομάδας για κάθε τιμή που υπάρχει στο πεδίο CloseDate:

BirtDateTime.week( row["CloseDate"] )

Το ακόλουθο παράδειγμα επιστρέφει τον αριθμό εβδομάδας της τρέχουσας ημερομηνίας:

BirtDateTime.week( (BirtDateTime.today() )

BirtDateTime.weekDay

Αυτή η συνάρτηση επιστρέφει την ημέρα της εβδομάδας για μια συγκεκριμένη ημερομηνία. Ανάλογα με την επιλογή σας, η συνάρτηση επιστρέφει την ημέρα της εβδομάδας ως αριθμό, το πλήρες όνομα ημέρας ή το σύντομο όνομα ημέρας. Το όνομα της ημέρας εξαρτάται από τις τοπικές ρυθμίσεις.

Σύνταξη

string BirtDateTime.weekDay( ημερομηνία, επιλογή )

Παράμετροι

ημερομηνία

Ένα αντικείμενο ημερομηνίας από το οποίο θα ανακτηθεί η ημέρα της εβδομάδας.

επιλογή

Ακέραιος. Προαιρετική. Ένας αριθμός που αναπαριστά τη μορφή που θα επιστραφεί. Χρησιμοποιήστε μία από τις ακόλουθες τιμές:

*
*
*
*
*

Αν παραλείψετε αυτό το όρισμα, η συνάρτηση χρησιμοποιεί την επιλογή 1.

Επιστρέφει

Σειρά χαρακτήρων. Η ημέρα της εβδομάδας για μια συγκεκριμένη ημερομηνία.

Παραδείγματα

Το ακόλουθο παράδειγμα παρουσιάζει τις τιμές ημέρας που επιστρέφονται για μια συγκεκριμένη ημερομηνία:

BirtDateTime.weekDay( "2009-02-02" ) // επιστρέφει την τιμή 2
BirtDateTime.weekDay( "2009-02-02", 2 ) // επιστρέφει την τιμή 1
BirtDateTime.weekDay( "2009-02-02", 4 ) // επιστρέφει την τιμή Δευτέρα

Το ακόλουθο παράδειγμα επιστρέφει την ημέρα της εβδομάδας για την τρέχουσα ημερομηνία:

BirtDateTime.weekDay( (BirtDateTime.today() )

BirtDateTime.year

Αυτή η συνάρτηση επιστρέφει την τετραψήφια τιμή έτους για μια συγκεκριμένη ημερομηνία. Για παράδειγμα, αν η ημερομηνία είναι 2009-01-19, η συνάρτηση επιστρέφει την τιμή 2009.

Σύνταξη

integer BirtDateTime.year( ημερομηνία )

Παράμετρος

ημερομηνία

Ένα αντικείμενο ημερομηνίας από το οποίο θα ανακτηθεί το έτος.

Επιστρέφει

Ακέραιος. Η τετραψήφια τιμή έτους για μια συγκεκριμένη ημερομηνία.

Παραδείγματα

Το ακόλουθο παράδειγμα επιστρέφει το έτος για κάθε τιμή που υπάρχει στο πεδίο HireDate:

BirtDateTime.year( row["HireDate"] )

Το ακόλουθο παράδειγμα επιστρέφει το έτος της τρέχουσας ημερομηνίας:

BirtDateTime.year( (BirtDateTime.today())

(c) Copyright Actuate Corporation 2013