Εκφράσεις και συναρτήσεις για το Data Factory στο Microsoft Fabric

Αυτό το άρθρο παρέχει λεπτομέρειες σχετικά με τις εκφράσεις και τις συναρτήσεις που υποστηρίζονται από το Data Factory στο Microsoft Fabric.

Παραστάσεις

Οι τιμές έκφρασης στον ορισμό μπορεί να είναι κυριολεκτικές ή εκφράσεις που αξιολογούνται κατά το χρόνο εκτέλεσης. Για παράδειγμα:

"value"

or

"@pipeline().parameters.password"

Οι εκφράσεις μπορούν να εμφανίζονται οπουδήποτε σε μια τιμή συμβολοσειράς και να οδηγούν πάντα σε μια άλλη τιμή συμβολοσειράς. Εάν μια τιμή είναι παράσταση, το σώμα της έκφρασης εξάγεται αφαιρώντας το σύμβολο @. Εάν απαιτείται μια κυριολεκτική συμβολοσειρά που ξεκινά με @, πρέπει να ξεφύγει χρησιμοποιώντας @@. Τα παρακάτω παραδείγματα δείχνουν πώς αξιολογούνται οι εκφράσεις.

Τιμή παράστασης	Result
"Παράμετροι"	Επιστρέφονται οι χαρακτήρες 'παράμετροι'.
"παράμετροι[1]"	Επιστρέφονται οι χαρακτήρες 'parameters[1]'.
"@@"	Επιστρέφεται μια συμβολοσειρά 1 χαρακτήρα που περιέχει '@'.
" @"	Επιστρέφεται μια συμβολοσειρά 2 χαρακτήρων που περιέχει ' @'.

Οι εκφράσεις μπορούν επίσης να εμφανίζονται μέσα σε συμβολοσειρές, χρησιμοποιώντας μια δυνατότητα που ονομάζεται παρεμβολή συμβολοσειράς , όπου οι εκφράσεις αναδιπλώνονται στο @{ ... }. Για παράδειγμα: "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

Χρησιμοποιώντας παρεμβολή συμβολοσειράς, το αποτέλεσμα είναι πάντα μια συμβολοσειρά. Ας πούμε ότι έχω ορίσει myNumber ως 42 και myString ως foo:

Τιμή παράστασης	Result
"@pipeline().parameters.myString"	Επιστρέφει foo ως συμβολοσειρά.
"@{pipeline().parameters.myString}"	Επιστρέφει foo ως συμβολοσειρά.
"@pipeline().parameters.myNumber"	Επιστρέφει 42 ως αριθμός.
"@{pipeline().parameters.myNumber}"	Επιστρέφει 42 ως συμβολοσειρά.
"Η απάντηση είναι: @{pipeline().parameters.myNumber}"	Επιστρέφει τη συμβολοσειρά Answer is: 42.
"@concat('Η απάντηση είναι: ', συμβολοσειρά (pipeline().parameters.myNumber))"	Επιστρέφει τη συμβολοσειρά Answer is: 42
"Η απάντηση είναι: @@{pipeline().parameters.myNumber}"	Επιστρέφει τη συμβολοσειρά Answer is: @{pipeline().parameters.myNumber}.

Στις δραστηριότητες ροής στοιχείων ελέγχου, όπως η δραστηριότητα ForEach, μπορείτε να παρέχετε έναν πίνακα που θα επαναλαμβάνεται για τα στοιχεία ιδιοτήτων και να χρησιμοποιείται @item() για επανάληψη μίας μόνο απαρίθμησης στη δραστηριότητα ForEach. Για παράδειγμα, εάν τα στοιχεία είναι πίνακας: [1, 2, 3], @item() επιστρέφει 1 στην πρώτη επανάληψη, 2 στη δεύτερη επανάληψη και 3 στην τρίτη επανάληψη. Μπορείτε επίσης να χρησιμοποιήσετε @range(0,10) έκφραση like για να επαναλάβετε 10 φορές ξεκινώντας με 0 και τελειώνοντας με 9.

Μπορείτε να χρησιμοποιήσετε @activity(το "όνομα δραστηριότητας") για να καταγράψετε τα αποτελέσματα της δραστηριότητας και να λάβετε αποφάσεις. Εξετάστε μια δραστηριότητα ιστού που ονομάζεται Web1. Για την τοποθέτηση της εξόδου της πρώτης δραστηριότητας στο σώμα της δεύτερης, η έκφραση γενικά μοιάζει με: @activity('Web1').output ή @activity('Web1').output.data ή κάτι παρόμοιο ανάλογα με το πώς φαίνεται η έξοδος της πρώτης δραστηριότητας.

Examples

Παράδειγμα σύνθετης έκφρασης

Το παρακάτω παράδειγμα δείχνει ένα σύνθετο παράδειγμα που αναφέρεται σε ένα βαθύ υποπεδίο εξόδου δραστηριότητας. Για να αναφέρετε μια παράμετρο διοχέτευσης που αποτιμάται σε ένα υποπεδίο, χρησιμοποιήστε σύνταξη [] αντί για τελεστή dot(.) (όπως στην περίπτωση των υποπεδίων1 και υποπεδίων2), ως μέρος μιας εξόδου δραστηριότητας.

@activity('*activityName*').output.*subfield1*.*subfield2*[pipeline().parameters.*subfield3*].*subfield4*

Η δυναμική δημιουργία αρχείων και η ονομασία τους είναι κοινό μοτίβο. Ας εξερευνήσουμε μερικά παραδείγματα δυναμικής ονομασίας αρχείων.

• Προσάρτηση ημερομηνίας σε όνομα αρχείου: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))
• Προσάρτηση DateTime στη ζώνη ώρας πελάτη: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))
• Προσάρτηση χρόνου ενεργοποίησης: @concat('Test_', pipeline().TriggerTime)
• Εξάγετε ένα προσαρμοσμένο όνομα αρχείου σε μια ροή δεδομένων αντιστοίχισης κατά την εξαγωγή σε ένα μεμονωμένο αρχείο με ημερομηνία: 'Test_' + toString(currentDate()) + '.csv'

Σε παραπάνω περιπτώσεις, δημιουργούνται τέσσερα δυναμικά ονόματα αρχείων ξεκινώντας από Test_.

Πρόγραμμα επεξεργασίας δυναμικού περιεχομένου

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

"@{toUpper('myData')}"

Το πρόγραμμα επεξεργασίας δυναμικού περιεχομένου μετατρέπει το παραπάνω περιεχόμενο σε έκφραση "@{toUpper('myData')}". Το αποτέλεσμα αυτής της έκφρασης είναι η μορφοποιημένη συμβολοσειρά που φαίνεται παρακάτω.

"MYDATA"

Αντικατάσταση ειδικών χαρακτήρων

Το δυναμικό πρόγραμμα επεξεργασίας περιεχομένου διαφεύγει αυτόματα χαρακτήρες όπως διπλά εισαγωγικά, ανάστροφη κάθετος στο περιεχόμενό σας όταν ολοκληρώσετε την επεξεργασία. Αυτό προκαλεί προβλήματα εάν θέλετε να αντικαταστήσετε την τροφοδοσία γραμμής ή το στηλοθέτη χρησιμοποιώντας \n, \t στη συνάρτηση replace(). Μπορείτε να επεξεργαστείτε το δυναμικό περιεχόμενό σας σε προβολή κώδικα για να καταργήσετε το επιπλέον \ στην έκφραση ή μπορείτε να ακολουθήσετε τα παρακάτω βήματα για να αντικαταστήσετε ειδικούς χαρακτήρες χρησιμοποιώντας γλώσσα έκφρασης:

1. Κωδικοποίηση URL σε σχέση με την αρχική τιμή συμβολοσειράς
2. Αντικαταστήστε την κωδικοποιημένη συμβολοσειρά URL, για παράδειγμα, αλλαγή γραμμής (%0A), επιστροφή μεταφοράς (%0D), οριζόντια καρτέλα (%09).
3. Αποκωδικοποίηση URL

Για παράδειγμα, η μεταβλητή companyName με ένα χαρακτήρα νέας γραμμής στην τιμή της, έκφραση @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) μπορεί να καταργήσει το χαρακτήρα νέας γραμμής.

Contoso- Corporation

Αποφυγή ενός χαρακτήρα εισαγωγικών

Οι συναρτήσεις έκφρασης χρησιμοποιούν ένα εισαγωγικό για παραμέτρους τιμής συμβολοσειράς. Χρησιμοποιήστε δύο μονά εισαγωγικά για να ξεφύγετε από ένα ' χαρακτήρα σε συναρτήσεις συμβολοσειράς. Για παράδειγμα, η έκφραση @concat('Baba', '''s ', 'book store') θα επιστρέψει κάτω από το αποτέλεσμα.

Baba's book store

Μεταβλητές εύρους διοχέτευσης

Αυτές οι μεταβλητές συστήματος μπορούν να αναφερθούν οπουδήποτε στη διοχέτευση.

Όνομα μεταβλητής	Περιγραφή
@pipeline().DataFactory	Αναγνωριστικό του χώρου εργασίας εντός του οποίου εκτελείται η διοχέτευση
@pipeline().Pipeline	Αναγνωριστικό της διοχέτευσης
@pipeline().PipelineName	Όνομα του αγωγού
@pipeline().RunId	Αναγνωριστικό της συγκεκριμένης εκτέλεσης διοχέτευσης
@pipeline().TriggerId	Αναγνωριστικό του ερεθίσματος που κάλεσε τη διοχέτευση
@pipeline().TriggerName	Όνομα του ερεθίσματος που κάλεσε τη διοχέτευση
@pipeline().TriggerTime	Ώρα εκτέλεσης ενεργοποίησης που κάλεσε τη διοχέτευση. Αυτή είναι η ώρα κατά την οποία η σκανδάλη ενεργοποιήθηκε πραγματικά για να καλέσει την εκτέλεση του αγωγού και μπορεί να διαφέρει ελαφρώς από την προγραμματισμένη ώρα της σκανδάλης.
@pipeline().GroupId	Αναγνωριστικό της ομάδας στην οποία ανήκει η εκτέλεση διοχέτευσης.
@pipeline()?. TriggeredByPipelineName	Όνομα της διοχέτευσης που ενεργοποιεί την εκτέλεση της διοχέτευσης. Ισχύει όταν η εκτέλεση διοχέτευσης ενεργοποιείται από μια δραστηριότητα ExecutePipeline. Αξιολογήστε σε Null όταν χρησιμοποιείται σε άλλες περιπτώσεις. Σημειώστε το ερωτηματικό μετά @pipeline()
@pipeline()?. TriggeredByPipelineRunId	Εκτελέστε το αναγνωριστικό της διοχέτευσης που ενεργοποιεί την εκτέλεση διοχέτευσης. Ισχύει όταν η εκτέλεση διοχέτευσης ενεργοποιείται από μια δραστηριότητα ExecutePipeline. Αξιολογήστε σε Null όταν χρησιμοποιείται σε άλλες περιπτώσεις. Σημειώστε το ερωτηματικό μετά @pipeline()

Σημείωμα

Οι μεταβλητές συστήματος ημερομηνίας/ώρας που σχετίζονται με το έναυσμα (τόσο στο πεδίο διοχέτευσης όσο και στο πεδίο ενεργοποίησης) επιστρέφουν ημερομηνίες UTC σε μορφή ISO 8601, για παράδειγμα, 2017-06-01T22:20:00.4061448Z.

Functions

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

Συναρτήσεις ημερομηνίας

Συνάρτηση ημερομηνίας ή ώρας	Εργασία
addDays	Προσθέστε έναν αριθμό ημερών σε μια χρονική σήμανση.
addHours	Προσθέστε έναν αριθμό ωρών σε μια χρονική σήμανση.
addMinutes	Προσθέστε έναν αριθμό λεπτών σε μια χρονική σήμανση.
addSeconds	Προσθέστε έναν αριθμό δευτερολέπτων σε μια χρονική σήμανση.
addToTime	Προσθέστε έναν αριθμό μονάδων χρόνου σε μια χρονική σήμανση. Δείτε επίσης getFutureTime.
convertFromUtc	Μετατρέψτε μια χρονική σήμανση από συντονισμένη παγκόσμια ώρα (UTC) στη ζώνη ώρας προορισμού.
μετατροπήΖώνη ώρας	Μετατρέψτε μια χρονική σήμανση από τη ζώνη ώρας προέλευσης στη ζώνη ώρας προορισμού.
convertToUtc	Μετατρέψτε μια χρονική σήμανση από τη ζώνη ώρας προέλευσης σε συντονισμένη παγκόσμια ώρα (UTC).
ημέραΤουΜήνα	Επιστρέψτε το στοιχείο ημέρας του μήνα από μια χρονική σήμανση.
ημέραΤηςΕβδομάδας	Επιστρέψτε το στοιχείο ημέρας της εβδομάδας από μια χρονική σήμανση.
ημέραΤουΈτος	Επιστρέψτε το στοιχείο ημέρας του έτους από μια χρονική σήμανση.
formatDateTime	Επιστρέψτε τη χρονική σήμανση ως συμβολοσειρά σε προαιρετική μορφή.
getFutureTime	Επιστρέψτε την τρέχουσα χρονική σήμανση συν τις καθορισμένες μονάδες χρόνου. Δείτε επίσης addToTime.
getPastTime	Επιστρέψτε την τρέχουσα χρονική σήμανση μείον τις καθορισμένες μονάδες χρόνου. Δείτε επίσης subtractFromTime.
startOfDay	Επιστρέψτε την έναρξη της ημέρας για μια χρονική σήμανση.
startOfHour	Επιστρέψτε την έναρξη της ώρας για μια χρονική σήμανση.
startOfMonth	Επιστρέψτε την αρχή του μήνα για μια χρονική σήμανση.
αφαιρείΑπόΏρα	Αφαιρέστε έναν αριθμό μονάδων χρόνου από μια χρονική σήμανση. Δείτε επίσης getPastTime.
Κρότωνες	Επιστρέφει την τιμή ιδιότητας ticks για μια καθορισμένη χρονική σήμανση.
utcNow	Επιστρέψτε την τρέχουσα χρονική σήμανση ως συμβολοσειρά.

Συναρτήσεις συμβολοσειρών

Για να εργαστείτε με συμβολοσειρές, μπορείτε να χρησιμοποιήσετε αυτές τις λειτουργίες συμβολοσειράς και επίσης ορισμένες λειτουργίες συλλογής. Οι συναρτήσεις συμβολοσειρών λειτουργούν μόνο σε συμβολοσειρές.

Συνάρτηση συμβολοσειράς	Εργασία
Κόνκατ	Συνδυάστε δύο ή περισσότερες συμβολοσειρές και επιστρέψτε τη συνδυασμένη συμβολοσειρά.
τελειώνειΜε	Ελέγξτε αν μια συμβολοσειρά τελειώνει με την καθορισμένη δευτερεύουσα συμβολοσειρά.
GUID	Δημιουργήστε ένα καθολικά μοναδικό αναγνωριστικό (GUID) ως συμβολοσειρά.
indexOf	Επιστρέψτε την αρχική θέση για μια δευτερεύουσα συμβολοσειρά.
lastIndexOf	Επιστρέψτε την αρχική θέση για την τελευταία εμφάνιση μιας δευτερεύουσας συμβολοσειράς.
αντικαθιστώ	Αντικαταστήστε μια δευτερεύουσα συμβολοσειρά με την καθορισμένη συμβολοσειρά και επιστρέψτε την ενημερωμένη συμβολοσειρά.
χωρίζω	Επιστρέφει έναν πίνακα που περιέχει δευτερεύουσες συμβολοσειρές, διαχωρισμένες με κόμματα, από μια μεγαλύτερη συμβολοσειρά που βασίζεται σε έναν καθορισμένο χαρακτήρα οριοθέτη στην αρχική συμβολοσειρά.
ξεκινάΜε	Ελέγξτε αν μια συμβολοσειρά ξεκινά με μια συγκεκριμένη δευτερεύουσα συμβολοσειρά.
Δευτερεύουσα συμβολοσειρά	Επιστροφή χαρακτήρων από μια συμβολοσειρά, ξεκινώντας από την καθορισμένη θέση.
προςΚάτω	Επιστρέψτε μια συμβολοσειρά με πεζά γράμματα.
έωςΆνω	Επιστρέψτε μια συμβολοσειρά σε κεφαλαία μορφή.
τάξη	Καταργήστε το αρχικό και το τελικό κενό διάστημα από μια συμβολοσειρά και επιστρέψτε την ενημερωμένη συμβολοσειρά.

Λειτουργίες συλλογής

Για να εργαστείτε με συλλογές, γενικά πίνακες, συμβολοσειρές και, μερικές φορές, λεξικά, μπορείτε να χρησιμοποιήσετε αυτές τις λειτουργίες συλλογής.

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

Λογικές συναρτήσεις

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

Λειτουργία λογικής σύγκρισης	Εργασία
και	Ελέγξτε αν όλες οι εκφράσεις είναι αληθείς.
ίσον	Ελέγξτε αν και οι δύο τιμές είναι ισοδύναμες.
μεγαλύτερη	Ελέγξτε αν η πρώτη τιμή είναι μεγαλύτερη από τη δεύτερη.
greaterOrEquals	Ελέγξτε αν η πρώτη τιμή είναι μεγαλύτερη ή ίση με τη δεύτερη.
αν	Ελέγξτε αν μια έκφραση είναι αληθής ή ψευδής. Με βάση το αποτέλεσμα, επιστρέψτε μια καθορισμένη τιμή.
λιγότερος	Ελέγξτε αν η πρώτη τιμή είναι μικρότερη από τη δεύτερη.
lessOrEquals	Ελέγξτε αν η πρώτη τιμή είναι μικρότερη ή ίση με τη δεύτερη.
όχι	Ελέγξτε αν μια έκφραση είναι ψευδής.
ή	Ελέγξτε αν τουλάχιστον μία έκφραση είναι αληθής.

Συναρτήσεις μετατροπής

Αυτές οι συναρτήσεις χρησιμοποιούνται για τη μετατροπή μεταξύ καθενός από τους εγγενείς τύπους στη γλώσσα:

• string
• ακέραιος
• επιπλέω
• boolean
• Συστοιχίες
• Λεξικά

Λειτουργία μετατροπής	Εργασία
παράταξη	Επιστρέφει έναν πίνακα από μία μόνο καθορισμένη είσοδο. Για πολλαπλές εισόδους, ανατρέξτε στο θέμα δημιουργία πίνακα.
Βάση64	Επιστρέψτε την έκδοση με κωδικοποίηση base64 για μια συμβολοσειρά.
base64ToBinary	Επιστρέψτε τη δυαδική έκδοση για μια συμβολοσειρά με κωδικοποίηση base64.
base64ToString	Επιστρέψτε την έκδοση συμβολοσειράς για μια συμβολοσειρά με κωδικοποίηση base64.
δυαδικός	Επιστρέψτε τη δυαδική έκδοση για μια τιμή εισόδου.
Μπουλ	Επιστρέψτε την έκδοση Boolean για μια τιμή εισόδου.
Συνένωση	Επιστρέφει την πρώτη μη μηδενική τιμή από μία ή περισσότερες παραμέτρους.
createArray	Επιστροφή ενός πίνακα από πολλές εισόδους.
dataUri	Επιστρέφει το URI δεδομένων για μια τιμή εισόδου.
dataUriToBinary	Επιστρέφει τη δυαδική έκδοση για ένα URI δεδομένων.
dataUriToString	Επιστρέψτε την έκδοση συμβολοσειράς για ένα URI δεδομένων.
αποκωδικοποίησηBase64	Επιστρέψτε την έκδοση συμβολοσειράς για μια συμβολοσειρά με κωδικοποίηση base64.
decodeDataUri	Επιστρέφει τη δυαδική έκδοση για ένα URI δεδομένων.
decodeUriComponent	Επιστρέφει μια συμβολοσειρά που αντικαθιστά τους χαρακτήρες escape με αποκωδικοποιημένες εκδόσεις.
encodeUriComponent	Επιστρέφει μια συμβολοσειρά που αντικαθιστά μη ασφαλείς χαρακτήρες URL με χαρακτήρες escape.
επιπλέω	Επιστρέφει έναν αριθμό κινητής υποδιαστολής για μια τιμή εισόδου.
ιντ	Επιστρέψτε την ακέραια έκδοση για μια συμβολοσειρά.
σειρά	Επιστρέψτε την έκδοση συμβολοσειράς για μια τιμή εισόδου.
uriComponent	Επιστρέψτε την έκδοση με κωδικοποίηση URI για μια τιμή εισόδου, αντικαθιστώντας τους μη ασφαλείς χαρακτήρες URL με χαρακτήρες escape.
uriComponentToBinary	Επιστρέψτε τη δυαδική έκδοση για μια συμβολοσειρά με κωδικοποίηση URI.
uriComponentToString	Επιστρέψτε την έκδοση συμβολοσειράς για μια συμβολοσειρά με κωδικοποίηση URI.
xml	Επιστρέψτε την έκδοση XML για μια συμβολοσειρά.
xPath	Ελέγξτε XML για κόμβους ή τιμές που ταιριάζουν με μια έκφραση XPath (XML Path Language) και επιστρέψτε τους κόμβους ή τις τιμές που ταιριάζουν.

Μαθηματικές συναρτήσεις

Αυτές οι συναρτήσεις μπορούν να χρησιμοποιηθούν και για τους δύο τύπους αριθμών: ακέραιους και πλωτήρες.

Συνάρτηση μαθηματικών	Εργασία
προσθέτω	Επιστρέφει το αποτέλεσμα από την προσθήκη δύο αριθμών.
τμήμα	Επιστρέφει το αποτέλεσμα από τη διαίρεση δύο αριθμών.
μέγ.	Επιστρέφει την υψηλότερη τιμή από ένα σύνολο αριθμών ή έναν πίνακα.
Λεπτά	Επιστρέφει τη χαμηλότερη τιμή από ένα σύνολο αριθμών ή έναν πίνακα.
MOD	Επιστρέψτε το υπόλοιπο από τη διαίρεση δύο αριθμών.
mul	Επιστρέψτε το προϊόν πολλαπλασιάζοντας δύο αριθμούς.
ραντ	Επιστρέφει έναν τυχαίο ακέραιο από μια καθορισμένη περιοχή.
έκταση	Επιστρέφει έναν ακέραιο πίνακα που ξεκινά από έναν καθορισμένο ακέραιο.
υπο	Επιστρέφει το αποτέλεσμα αφαιρώντας τον δεύτερο αριθμό από τον πρώτο αριθμό.

Αναφορά συνάρτησης

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

προσθέτω

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

add(<summand_1>, <summand_2>)

Παράμετρος	Required	Τύπος	Περιγραφή
< summand_1>, <summand_2>	Yes	Ακέραιος, Κυμαινόμενος ή μεικτός	Οι αριθμοί που πρέπει να προσθέσετε

Τιμή επιστροφής	Τύπος	Περιγραφή
< αποτέλεσμα-άθροισμα>	Ακέραιος ή κυμαινόμενος	Το αποτέλεσμα από την προσθήκη των καθορισμένων αριθμών

Παράδειγμα

Αυτό το παράδειγμα προσθέτει τους καθορισμένους αριθμούς:

add(1, 1.5)

Και επιστρέφει αυτό το αποτέλεσμα: 2.5

addDays

Προσθέστε έναν αριθμό ημερών σε μια χρονική σήμανση.

addDays('<timestamp>', <days>, '<format>'?)

Παράμετρος	Required	Τύπος	Περιγραφή
< Χρονική σήμανση>	Yes	Συμβλοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση
< Ημέρες>	Yes	Integer	Ο θετικός ή αρνητικός αριθμός ημερών για προσθήκη
< Μορφή>	No	Συμβλοσειρά	Είτε ένα προσδιοριστικό μεμονωμένης μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-μμ-ηηTHΩ:λλ:ss.fffffffK), η οποία συμμορφώνεται με το πρότυπο ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Τιμή επιστροφής	Τύπος	Περιγραφή
< ενημερωμένη-χρονική σήμανση>	Συμβλοσειρά	Η χρονική σήμανση συν τον καθορισμένο αριθμό ημερών

Παράδειγμα 1

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

addDays('2018-03-15T13:00:00Z', 10)

Και επιστρέφει αυτό το αποτέλεσμα: "2018-03-25T00:00:0000000Z"

Παράδειγμα 2

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

addDays('2018-03-15T00:00:00Z', -5)

Και επιστρέφει αυτό το αποτέλεσμα: "2018-03-10T00:00:0000000Z"

addHours

Προσθέστε έναν αριθμό ωρών σε μια χρονική σήμανση.

addHours('<timestamp>', <hours>, '<format>'?)

Παράμετρος	Required	Τύπος	Περιγραφή
< Χρονική σήμανση>	Yes	Συμβλοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση
< Ώρες>	Yes	Integer	Ο θετικός ή αρνητικός αριθμός ωρών για προσθήκη
< Μορφή>	No	Συμβλοσειρά	Είτε ένα προσδιοριστικό μεμονωμένης μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-μμ-ηηTHΩ:λλ:ss.fffffffK), η οποία συμμορφώνεται με το πρότυπο ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Τιμή επιστροφής	Τύπος	Περιγραφή
< ενημερωμένη-χρονική σήμανση>	Συμβλοσειρά	Η χρονική σήμανση συν τον καθορισμένο αριθμό ωρών

Παράδειγμα 1

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

addHours('2018-03-15T00:00:00Z', 10)

Και επιστρέφει αυτό το αποτέλεσμα: "2018-03-15T10:00:0000000Z"

Παράδειγμα 2

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

addHours('2018-03-15T15:00:00Z', -5)

Και επιστρέφει αυτό το αποτέλεσμα: "2018-03-15T10:00:0000000Z"

addMinutes

Προσθέστε έναν αριθμό λεπτών σε μια χρονική σήμανση.

addMinutes('<timestamp>', <minutes>, '<format>'?)

Παράμετρος	Required	Τύπος	Περιγραφή
< Χρονική σήμανση>	Yes	Συμβλοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση
< πρακτικά>	Yes	Integer	Ο θετικός ή αρνητικός αριθμός λεπτών για προσθήκη
< Μορφή>	No	Συμβλοσειρά	Είτε ένα προσδιοριστικό μεμονωμένης μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-μμ-ηηTHΩ:λλ:ss.fffffffK), η οποία συμμορφώνεται με το πρότυπο ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Τιμή επιστροφής	Τύπος	Περιγραφή
< ενημερωμένη-χρονική σήμανση>	Συμβλοσειρά	Η χρονική σήμανση συν τον καθορισμένο αριθμό λεπτών

Παράδειγμα 1

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

addMinutes('2018-03-15T00:10:00Z', 10)

Και επιστρέφει αυτό το αποτέλεσμα: "2018-03-15T00:20:00.0000000Z"

Παράδειγμα 2

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

addMinutes('2018-03-15T00:20:00Z', -5)

Και επιστρέφει αυτό το αποτέλεσμα: "2018-03-15T00:15:00.0000000Z"

addSeconds

Προσθέστε έναν αριθμό δευτερολέπτων σε μια χρονική σήμανση.

addSeconds('<timestamp>', <seconds>, '<format>'?)

Παράμετρος	Required	Τύπος	Περιγραφή
< Χρονική σήμανση>	Yes	Συμβλοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση
< Δευτερόλεπτα>	Yes	Integer	Ο θετικός ή αρνητικός αριθμός δευτερολέπτων για προσθήκη
< Μορφή>	No	Συμβλοσειρά	Είτε ένα προσδιοριστικό μεμονωμένης μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-μμ-ηηTHΩ:λλ:ss.fffffffK), η οποία συμμορφώνεται με το πρότυπο ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Τιμή επιστροφής	Τύπος	Περιγραφή
< ενημερωμένη-χρονική σήμανση>	Συμβλοσειρά	Η χρονική σήμανση συν τον καθορισμένο αριθμό δευτερολέπτων

Παράδειγμα 1

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

addSeconds('2018-03-15T00:00:00Z', 10)

Και επιστρέφει αυτό το αποτέλεσμα: "2018-03-15T00:00:10.0000000Z"

Παράδειγμα 2

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

addSeconds('2018-03-15T00:00:30Z', -5)

Και επιστρέφει αυτό το αποτέλεσμα: "2018-03-15T00:00:25.0000000Z"

addToTime

Προσθέστε έναν αριθμό μονάδων χρόνου σε μια χρονική σήμανση. Δείτε επίσης getFutureTime().

addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)

Παράμετρος	Required	Τύπος	Περιγραφή
< Χρονική σήμανση>	Yes	Συμβλοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση
< διάστημα>	Yes	Integer	Ο αριθμός των καθορισμένων μονάδων χρόνου που θα προστεθούν
< Μονάδα χρόνου>	Yes	Συμβλοσειρά	Η μονάδα χρόνου που χρησιμοποιείται με το διάστημα: "Δεύτερο", "Λεπτό", "Ώρα", "Ημέρα", "Εβδομάδα", "Μήνας", "Έτος"
< Μορφή>	No	Συμβλοσειρά	Είτε ένα προσδιοριστικό μεμονωμένης μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-μμ-ηηTHΩ:λλ:ss.fffffffK), η οποία συμμορφώνεται με το πρότυπο ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Τιμή επιστροφής	Τύπος	Περιγραφή
< ενημερωμένη-χρονική σήμανση>	Συμβλοσειρά	Η χρονική σήμανση συν τον καθορισμένο αριθμό μονάδων χρόνου

Παράδειγμα 1

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

addToTime('2018-01-01T00:00:00Z', 1, 'Day')

Και επιστρέφει αυτό το αποτέλεσμα: "2018-01-02T00:00:00.0000000Z"

Παράδειγμα 2

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

addToTime('2018-01-01T00:00:00Z', 1, 'Day', 'D')

Και επιστρέφει το αποτέλεσμα χρησιμοποιώντας την προαιρετική μορφή "D": "Tuesday, January 2, 2018"

and

Ελέγξτε αν και οι δύο εκφράσεις είναι αληθείς. Επιστρέψτε true όταν και οι δύο εκφράσεις είναι true ή επιστρέψτε false όταν τουλάχιστον μία παράσταση είναι false.

and(<expression1>, <expression2>)

Παράμετρος	Required	Τύπος	Περιγραφή
< έκφραση1>, <έκφραση2>	Yes	Boolean	Οι εκφράσεις προς έλεγχο

Τιμή επιστροφής	Τύπος	Περιγραφή
Σωστό ή Λάθος	Boolean	Επιστρέψτε true όταν και οι δύο εκφράσεις είναι αληθείς. Επιστρέψτε false όταν τουλάχιστον μία έκφραση είναι false.

Παράδειγμα 1

Αυτά τα παραδείγματα ελέγχουν αν οι καθορισμένες τιμές Boolean είναι και οι δύο αληθείς:

and(true, true)
and(false, true)
and(false, false)

Και επιστρέφει αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: Και οι δύο εκφράσεις είναι αληθείς, επομένως επιστρέφει true.
• Δεύτερο παράδειγμα: Μία έκφραση είναι false, επομένως επιστρέφει false.
• Τρίτο παράδειγμα: Και οι δύο εκφράσεις είναι ψευδείς, επομένως επιστρέφει false.

Παράδειγμα 2

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

and(equals(1, 1), equals(2, 2))
and(equals(1, 1), equals(1, 2))
and(equals(1, 2), equals(1, 3))

Και επιστρέφει αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: Και οι δύο εκφράσεις είναι αληθείς, επομένως επιστρέφει true.
• Δεύτερο παράδειγμα: Μία έκφραση είναι false, επομένως επιστρέφει false.
• Τρίτο παράδειγμα: Και οι δύο εκφράσεις είναι ψευδείς, επομένως επιστρέφει false.

παράταξη

Επιστρέφει έναν πίνακα από μία μόνο καθορισμένη είσοδο. Για πολλαπλές εισόδους, δείτε createArray().

array('<value>')

Παράμετρος	Required	Τύπος	Περιγραφή
< τιμή>	Yes	Συμβλοσειρά	Η συμβολοσειρά για τη δημιουργία ενός πίνακα

Τιμή επιστροφής	Τύπος	Περιγραφή
[<αξία>]	Παράταξη	Ένας πίνακας που περιέχει τη μοναδική καθορισμένη είσοδο

Παράδειγμα

Αυτό το παράδειγμα δημιουργεί έναν πίνακα από τη συμβολοσειρά "hello":

array('hello')

Και επιστρέφει αυτό το αποτέλεσμα: ["hello"]

Βάση64

Επιστρέψτε την έκδοση με κωδικοποίηση base64 για μια συμβολοσειρά.

base64('<value>')

Παράμετρος	Required	Τύπος	Περιγραφή
< τιμή>	Yes	Συμβλοσειρά	Η συμβολοσειρά εισόδου

Τιμή επιστροφής	Τύπος	Περιγραφή
< base64-συμβολοσειρά>	Συμβλοσειρά	Η έκδοση με κωδικοποίηση base64 για τη συμβολοσειρά εισόδου

Παράδειγμα

Αυτό το παράδειγμα μετατρέπει τη συμβολοσειρά "hello" σε συμβολοσειρά με κωδικοποίηση base64:

base64('hello')

Και επιστρέφει αυτό το αποτέλεσμα: "aGVsbG8="

base64ToBinary

Επιστρέψτε τη δυαδική έκδοση για μια συμβολοσειρά με κωδικοποίηση base64.

base64ToBinary('<value>')

Παράμετρος	Required	Τύπος	Περιγραφή
< τιμή>	Yes	Συμβλοσειρά	Η συμβολοσειρά με κωδικοποίηση base64 για μετατροπή

Τιμή επιστροφής	Τύπος	Περιγραφή
< δυαδική για βάση64-συμβολοσειρά>	Συμβλοσειρά	Η δυαδική έκδοση για τη συμβολοσειρά με κωδικοποίηση base64

Παράδειγμα

Αυτό το παράδειγμα μετατρέπει τη συμβολοσειρά με κωδικοποίηση base64 "aGVsbG8=" σε δυαδική συμβολοσειρά:

base64ToBinary('aGVsbG8=')

Και επιστρέφει αυτό το αποτέλεσμα:

"0110000101000111010101100111001101100010010001110011100000111101"

base64ToString

Επιστρέψτε την έκδοση συμβολοσειράς για μια συμβολοσειρά με κωδικοποίηση base64, αποκωδικοποιώντας αποτελεσματικά τη συμβολοσειρά base64. Χρησιμοποιήστε αυτήν τη συνάρτηση αντί για decodeBase64(). Αν και οι δύο λειτουργίες λειτουργούν με τον ίδιο τρόπο, base64ToString() προτιμάται.

base64ToString('<value>')

Παράμετρος	Required	Τύπος	Περιγραφή
< τιμή>	Yes	Συμβλοσειρά	Η συμβολοσειρά με κωδικοποίηση base64 για αποκωδικοποίηση

Τιμή επιστροφής	Τύπος	Περιγραφή
< αποκωδικοποιημένη-βάση64-συμβολοσειρά>	Συμβλοσειρά	Η έκδοση συμβολοσειράς για μια συμβολοσειρά με κωδικοποίηση base64

Παράδειγμα

Αυτό το παράδειγμα μετατρέπει τη συμβολοσειρά με κωδικοποίηση base64 "aGVsbG8=" σε μια συμβολοσειρά:

base64ToString('aGVsbG8=')

Και επιστρέφει αυτό το αποτέλεσμα: "hello"

δυαδικός

Επιστρέψτε τη δυαδική έκδοση για μια συμβολοσειρά.

binary('<value>')

Παράμετρος	Required	Τύπος	Περιγραφή
< τιμή>	Yes	Συμβλοσειρά	Η συμβολοσειρά για μετατροπή

Τιμή επιστροφής	Τύπος	Περιγραφή
< δυαδική τιμή εισόδου>	Συμβλοσειρά	Η δυαδική έκδοση για την καθορισμένη συμβολοσειρά

Παράδειγμα

Αυτό το παράδειγμα μετατρέπει τη συμβολοσειρά "hello" σε δυαδική συμβολοσειρά:

binary('hello')

Και επιστρέφει αυτό το αποτέλεσμα:

"0110100001100101011011000110110001101111"

bool

Επιστρέψτε την έκδοση Boolean για μια τιμή.

bool(<value>)

Παράμετρος	Required	Τύπος	Περιγραφή
< τιμή>	Yes	Όποιος	Η τιμή προς μετατροπή

Τιμή επιστροφής	Τύπος	Περιγραφή
Σωστό ή Λάθος	Boolean	Η έκδοση Boolean για την καθορισμένη τιμή

Παράδειγμα

Αυτά τα παραδείγματα μετατρέπουν τις καθορισμένες τιμές σε τιμές Boolean:

bool(1)
bool(0)

Και επιστρέφει αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: true
• Δεύτερο παράδειγμα: false

Συνένωση

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

coalesce(<object_1>, <object_2>, ...)

Παράμετρος	Required	Τύπος	Περιγραφή
< object_1>, <object_2>, ...	Yes	Οποιοσδήποτε, μπορεί να αναμίξει τύπους	Ένα ή περισσότερα στοιχεία για έλεγχο null

Τιμή επιστροφής	Τύπος	Περιγραφή
< Πρώτο-μη-μηδενικό-στοιχείο>	Όποιος	Το πρώτο στοιχείο ή τιμή που δεν είναι null. Εάν όλες οι παράμετροι είναι null, αυτή η συνάρτηση επιστρέφει null.

Παράδειγμα

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

coalesce(null, true, false)
coalesce(null, 'hello', 'world')
coalesce(null, null, null)

Και επιστρέφει αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: true
• Δεύτερο παράδειγμα: "hello"
• Τρίτο παράδειγμα: null

Κόνκατ

Συνδυάστε δύο ή περισσότερες συμβολοσειρές και επιστρέψτε τη συνδυασμένη συμβολοσειρά.

concat('<text1>', '<text2>', ...)

Παράμετρος	Required	Τύπος	Περιγραφή
< κείμενο1>, <κείμενο2>, ...	Yes	Συμβλοσειρά	Τουλάχιστον δύο συμβολοσειρές για συνδυασμό

Τιμή επιστροφής	Τύπος	Περιγραφή
< κείμενο1κείμενο2...>	Συμβλοσειρά	Η συμβολοσειρά που δημιουργείται από τις συνδυασμένες συμβολοσειρές εισόδου

Παράδειγμα

Αυτό το παράδειγμα συνδυάζει τις συμβολοσειρές "Hello" και "World":

concat('Hello', 'World')

Και επιστρέφει αυτό το αποτέλεσμα: "HelloWorld"

Περιέχει

Ελέγξτε αν μια συλλογή έχει ένα συγκεκριμένο στοιχείο. Επιστρέψτε true όταν βρεθεί το στοιχείο ή επιστρέψτε false όταν δεν βρεθεί. Αυτή η λειτουργία κάνει διάκριση πεζών-κεφαλαίων.

contains('<collection>', '<value>')
contains([<collection>], '<value>')

Συγκεκριμένα, αυτή η λειτουργία λειτουργεί σε αυτούς τους τύπους συλλογής:

• Μια συμβολοσειρά για την εύρεση μιας δευτερεύουσας συμβολοσειράς
• Ένας πίνακας για την εύρεση μιας τιμής
• Ένα λεξικό για την εύρεση ενός κλειδιού

Παράμετρος	Required	Τύπος	Περιγραφή
< συλλογή>	Yes	Συμβολοσειρά, πίνακας ή λεξικό	Η συλλογή για έλεγχο
< τιμή>	Yes	Συμβολοσειρά, πίνακας ή λεξικό, αντίστοιχα	Το στοιχείο που πρέπει να βρείτε

Τιμή επιστροφής	Τύπος	Περιγραφή
Σωστό ή Λάθος	Boolean	Επιστρέψτε true όταν βρεθεί το στοιχείο. Επιστρέψτε false όταν δεν βρέθηκε.

Παράδειγμα 1

Αυτό το παράδειγμα ελέγχει τη συμβολοσειρά "hello world" για την υποσυμβολοσειρά "world" και επιστρέφει true:

contains('hello world', 'world')

Παράδειγμα 2

Αυτό το παράδειγμα ελέγχει τη συμβολοσειρά "hello world" για την υποσυμβολοσειρά "universe" και επιστρέφει false:

contains('hello world', 'universe')

convertFromUtc

Μετατρέψτε μια χρονική σήμανση από συντονισμένη παγκόσμια ώρα (UTC) στη ζώνη ώρας προορισμού.

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)

Παράμετρος	Required	Τύπος	Περιγραφή
< Χρονική σήμανση>	Yes	Συμβλοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση
< προορισμόςΖώνη ώρας>	Yes	Συμβλοσειρά	Το όνομα για τη ζώνη ώρας προορισμού. Για ονόματα ζώνης ώρας, ανατρέξτε στο θέμα Τιμές ζώνης ώρας της Microsoft, αλλά ίσως χρειαστεί να καταργήσετε τυχόν σημεία στίξης από το όνομα ζώνης ώρας.
< Μορφή>	No	Συμβλοσειρά	Είτε ένα προσδιοριστικό μεμονωμένης μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-μμ-ηηTHΩ:λλ:ss.fffffffK), η οποία συμμορφώνεται με το πρότυπο ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Τιμή επιστροφής	Τύπος	Περιγραφή
< Χρονική σήμανση μετατροπής>	Συμβλοσειρά	Η χρονική σήμανση μετατράπηκε στη ζώνη ώρας προορισμού

Παράδειγμα 1

Αυτό το παράδειγμα μετατρέπει μια χρονική σήμανση στην καθορισμένη ζώνη ώρας:

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time')

Και επιστρέφει αυτό το αποτέλεσμα: "2018-01-01T00:00:00Z"

Παράδειγμα 2

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

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time', 'D')

Και επιστρέφει αυτό το αποτέλεσμα: "Monday, January 1, 2018"

μετατροπήΖώνη ώρας

Μετατρέψτε μια χρονική σήμανση από τη ζώνη ώρας προέλευσης στη ζώνη ώρας προορισμού.

convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)

Παράμετρος	Required	Τύπος	Περιγραφή
< Χρονική σήμανση>	Yes	Συμβλοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση
< πηγήΖώνη ώρας>	Yes	Συμβλοσειρά	Το όνομα για τη ζώνη ώρας προέλευσης. Για ονόματα ζώνης ώρας, ανατρέξτε στο θέμα Τιμές ζώνης ώρας της Microsoft, αλλά ίσως χρειαστεί να καταργήσετε τυχόν σημεία στίξης από το όνομα ζώνης ώρας.
< προορισμόςΖώνη ώρας>	Yes	Συμβλοσειρά	Το όνομα για τη ζώνη ώρας προορισμού. Για ονόματα ζώνης ώρας, ανατρέξτε στο θέμα Τιμές ζώνης ώρας της Microsoft, αλλά ίσως χρειαστεί να καταργήσετε τυχόν σημεία στίξης από το όνομα ζώνης ώρας.
< Μορφή>	No	Συμβλοσειρά	Είτε ένα προσδιοριστικό μεμονωμένης μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-μμ-ηηTHΩ:λλ:ss.fffffffK), η οποία συμμορφώνεται με το πρότυπο ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Τιμή επιστροφής	Τύπος	Περιγραφή
< Χρονική σήμανση μετατροπής>	Συμβλοσειρά	Η χρονική σήμανση μετατράπηκε στη ζώνη ώρας προορισμού

Παράδειγμα 1

Αυτό το παράδειγμα μετατρέπει τη ζώνη ώρας προέλευσης στη ζώνη ώρας προορισμού:

convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time')

Και επιστρέφει αυτό το αποτέλεσμα: "2018-01-01T00:00:00.0000000"

Παράδειγμα 2

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

convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time', 'D')

Και επιστρέφει αυτό το αποτέλεσμα: "Monday, January 1, 2018"

convertToUtc

Μετατρέψτε μια χρονική σήμανση από τη ζώνη ώρας προέλευσης σε συντονισμένη παγκόσμια ώρα (UTC).

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)

Παράμετρος	Required	Τύπος	Περιγραφή
< Χρονική σήμανση>	Yes	Συμβλοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση
< πηγήΖώνη ώρας>	Yes	Συμβλοσειρά	Το όνομα για τη ζώνη ώρας προέλευσης. Για ονόματα ζώνης ώρας, ανατρέξτε στο θέμα Τιμές ζώνης ώρας της Microsoft, αλλά ίσως χρειαστεί να καταργήσετε τυχόν σημεία στίξης από το όνομα ζώνης ώρας.
< Μορφή>	No	Συμβλοσειρά	Είτε ένα προσδιοριστικό μεμονωμένης μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-μμ-ηηTHΩ:λλ:ss.fffffffK), η οποία συμμορφώνεται με το πρότυπο ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Τιμή επιστροφής	Τύπος	Περιγραφή
< Χρονική σήμανση μετατροπής>	Συμβλοσειρά	Η χρονική σήμανση μετατράπηκε σε UTC

Παράδειγμα 1

Αυτό το παράδειγμα μετατρέπει μια χρονική σήμανση σε UTC:

convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time')

Και επιστρέφει αυτό το αποτέλεσμα: "2018-01-01T08:00:00.0000000Z"

Παράδειγμα 2

Αυτό το παράδειγμα μετατρέπει μια χρονική σήμανση σε UTC:

convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time', 'D')

Και επιστρέφει αυτό το αποτέλεσμα: "Monday, January 1, 2018"

createArray

Επιστροφή ενός πίνακα από πολλές εισόδους. Για πίνακες μίας εισόδου, δείτε την ενότητα πίνακας().

createArray('<object1>', '<object2>', ...)

Παράμετρος	Required	Τύπος	Περιγραφή
< Αντικείμενο1>, <Αντικείμενο2>, ...	Yes	Οποιαδήποτε, αλλά όχι μικτή	Τουλάχιστον δύο στοιχεία για τη δημιουργία του πίνακα

Τιμή επιστροφής	Τύπος	Περιγραφή
[<αντικείμενο1>, <αντικείμενο2>, ...]	Παράταξη	Ο πίνακας που δημιουργήθηκε από όλα τα στοιχεία εισόδου

Παράδειγμα

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

createArray('h', 'e', 'l', 'l', 'o')

Και επιστρέφει αυτό το αποτέλεσμα: ["h", "e", "l", "l", "o"]

dataUri

Επιστρέψτε ένα ενιαίο αναγνωριστικό πόρου (URI) δεδομένων για μια συμβολοσειρά.

dataUri('<value>')

Παράμετρος	Required	Τύπος	Περιγραφή
< τιμή>	Yes	Συμβλοσειρά	Η συμβολοσειρά για μετατροπή

Τιμή επιστροφής	Τύπος	Περιγραφή
< data-uri>	Συμβλοσειρά	Το URI δεδομένων για τη συμβολοσειρά εισόδου

Παράδειγμα

Αυτό το παράδειγμα δημιουργεί ένα URI δεδομένων για τη συμβολοσειρά "hello":

dataUri('hello')

Και επιστρέφει αυτό το αποτέλεσμα: "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

Επιστρέψτε τη δυαδική έκδοση για ένα ενιαίο αναγνωριστικό πόρου δεδομένων (URI). Χρησιμοποιήστε αυτήν τη συνάρτηση αντί για decodeDataUri(). Αν και οι δύο λειτουργίες λειτουργούν με τον ίδιο τρόπο, dataUriBinary() προτιμάται.

dataUriToBinary('<value>')

Παράμετρος	Required	Τύπος	Περιγραφή
< τιμή>	Yes	Συμβλοσειρά	Το URI δεδομένων για μετατροπή

Τιμή επιστροφής	Τύπος	Περιγραφή
< δυαδικό-για-δεδομένα-uri>	Συμβλοσειρά	Η δυαδική έκδοση για το URI δεδομένων

Παράδειγμα

Αυτό το παράδειγμα δημιουργεί μια δυαδική έκδοση για αυτό το URI δεδομένων:

dataUriToBinary('data:text/plain;charset=utf-8;base64,aGVsbG8=')

Και επιστρέφει αυτό το αποτέλεσμα:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Επιστρέψτε την έκδοση συμβολοσειράς για ένα ενιαίο αναγνωριστικό πόρου δεδομένων (URI).

dataUriToString('<value>')

Παράμετρος	Required	Τύπος	Περιγραφή
< τιμή>	Yes	Συμβλοσειρά	Το URI δεδομένων για μετατροπή

Τιμή επιστροφής	Τύπος	Περιγραφή
< συμβολοσειρά-για-δεδομένα-uri>	Συμβλοσειρά	Η έκδοση συμβολοσειράς για το URI δεδομένων

Παράδειγμα

Αυτό το παράδειγμα δημιουργεί μια συμβολοσειρά για αυτό το URI δεδομένων:

dataUriToString('data:text/plain;charset=utf-8;base64,aGVsbG8=')

Και επιστρέφει αυτό το αποτέλεσμα: "hello"

ημέραΤουΜήνα

Επιστρέψτε την ημέρα του μήνα από μια χρονική σήμανση.

dayOfMonth('<timestamp>')

Παράμετρος	Required	Τύπος	Περιγραφή
< Χρονική σήμανση>	Yes	Συμβλοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση

Τιμή επιστροφής	Τύπος	Περιγραφή
< ημέρα του μήνα>	Integer	Η ημέρα του μήνα από την καθορισμένη χρονική σήμανση

Παράδειγμα

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

dayOfMonth('2018-03-15T13:27:36Z')

Και επιστρέφει αυτό το αποτέλεσμα: 15

ημέραΤηςΕβδομάδας

Επιστροφή της ημέρας της εβδομάδας από μια χρονική σήμανση.

dayOfWeek('<timestamp>')

Παράμετρος	Required	Τύπος	Περιγραφή
< Χρονική σήμανση>	Yes	Συμβλοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση

Τιμή επιστροφής	Τύπος	Περιγραφή
< ημέρα της εβδομάδας>	Integer	Η ημέρα της εβδομάδας από την καθορισμένη χρονική σήμανση όπου η Κυριακή είναι 0, η Δευτέρα είναι 1 και ούτω καθεξής

Παράδειγμα

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

dayOfWeek('2018-03-15T13:27:36Z')

Και επιστρέφει αυτό το αποτέλεσμα: 3

ημέραΤουΈτος

Επιστρέψτε την ημέρα του έτους από μια χρονική σήμανση.

dayOfYear('<timestamp>')

Παράμετρος	Required	Τύπος	Περιγραφή
< Χρονική σήμανση>	Yes	Συμβλοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση

Τιμή επιστροφής	Τύπος	Περιγραφή
< ημέρα του χρόνου>	Integer	Η ημέρα του έτους από την καθορισμένη χρονική σήμανση

Παράδειγμα

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

dayOfYear('2018-03-15T13:27:36Z')

Και επιστρέφει αυτό το αποτέλεσμα: 74

αποκωδικοποίησηBase64

Επιστρέψτε την έκδοση συμβολοσειράς για μια συμβολοσειρά με κωδικοποίηση base64, αποκωδικοποιώντας αποτελεσματικά τη συμβολοσειρά base64. Εξετάστε το ενδεχόμενο να χρησιμοποιήσετε το base64ToString() αντί για decodeBase64()το . Αν και οι δύο λειτουργίες λειτουργούν με τον ίδιο τρόπο, base64ToString() προτιμάται.

decodeBase64('<value>')

Παράμετρος	Required	Τύπος	Περιγραφή
< τιμή>	Yes	Συμβλοσειρά	Η συμβολοσειρά με κωδικοποίηση base64 για αποκωδικοποίηση

Τιμή επιστροφής	Τύπος	Περιγραφή
< αποκωδικοποιημένη-βάση64-συμβολοσειρά>	Συμβλοσειρά	Η έκδοση συμβολοσειράς για μια συμβολοσειρά με κωδικοποίηση base64

Παράδειγμα

Αυτό το παράδειγμα δημιουργεί μια συμβολοσειρά για μια συμβολοσειρά με κωδικοποίηση base64:

decodeBase64('aGVsbG8=')

Και επιστρέφει αυτό το αποτέλεσμα: "hello"

decodeDataUri

Επιστρέψτε τη δυαδική έκδοση για ένα ενιαίο αναγνωριστικό πόρου δεδομένων (URI). Εξετάστε το ενδεχόμενο να χρησιμοποιήσετε το dataUriToBinary(), αντί για decodeDataUri()το . Αν και οι δύο λειτουργίες λειτουργούν με τον ίδιο τρόπο, dataUriToBinary() προτιμάται.

decodeDataUri('<value>')

Παράμετρος	Required	Τύπος	Περιγραφή
< τιμή>	Yes	Συμβλοσειρά	Η συμβολοσειρά URI δεδομένων για αποκωδικοποίηση

Τιμή επιστροφής	Τύπος	Περιγραφή
< δυαδικό-για-δεδομένα-uri>	Συμβλοσειρά	Η δυαδική έκδοση για μια συμβολοσειρά URI δεδομένων

Παράδειγμα

Αυτό το παράδειγμα επιστρέφει τη δυαδική έκδοση για αυτό το URI δεδομένων:

decodeDataUri('data:text/plain;charset=utf-8;base64,aGVsbG8=')

Και επιστρέφει αυτό το αποτέλεσμα:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

decodeUriComponent

Επιστρέφει μια συμβολοσειρά που αντικαθιστά τους χαρακτήρες escape με αποκωδικοποιημένες εκδόσεις.

decodeUriComponent('<value>')

Παράμετρος	Required	Τύπος	Περιγραφή
< τιμή>	Yes	Συμβλοσειρά	Η συμβολοσειρά με τους χαρακτήρες διαφυγής για αποκωδικοποίηση

Τιμή επιστροφής	Τύπος	Περιγραφή
< αποκωδικοποιημένο-URI>	Συμβλοσειρά	Η ενημερωμένη συμβολοσειρά με τους αποκωδικοποιημένους χαρακτήρες διαφυγής

Παράδειγμα

Αυτό το παράδειγμα αντικαθιστά τους χαρακτήρες escape σε αυτήν τη συμβολοσειρά με αποκωδικοποιημένες εκδόσεις:

decodeUriComponent('http%3A%2F%2Fcontoso.com')

Και επιστρέφει αυτό το αποτέλεσμα: "https://contoso.com"

τμήμα

Επιστρέφει το ακέραιο αποτέλεσμα από τη διαίρεση δύο αριθμών. Για να λάβετε το υπόλοιπο αποτέλεσμα, δείτε mod().

div(<dividend>, <divisor>)

Παράμετρος	Required	Τύπος	Περιγραφή
< μέρισμα>	Yes	Ακέραιος ή κυμαινόμενος	Ο αριθμός που θα διαιρεθεί με τον διαιρέτη
< διαιρέτης>	Yes	Ακέραιος ή κυμαινόμενος	Ο αριθμός που διαιρεί το μέρισμα, αλλά δεν μπορεί να είναι 0

Τιμή επιστροφής	Τύπος	Περιγραφή
< πηλίκο-αποτέλεσμα>	Integer	Ο ακέραιος προκύπτει από τη διαίρεση του πρώτου αριθμού με τον δεύτερο αριθμό

Παράδειγμα

Και τα δύο παραδείγματα διαιρούν τον πρώτο αριθμό με τον δεύτερο αριθμό:

div(10, 5)
div(11, 5)

Και επιστρέψτε αυτό το αποτέλεσμα: 2

encodeUriComponent

Επιστρέψτε μια κωδικοποιημένη έκδοση ενιαίου αναγνωριστικού πόρου (URI) για μια συμβολοσειρά, αντικαθιστώντας τους μη ασφαλείς χαρακτήρες URL με χαρακτήρες escape. Εξετάστε το ενδεχόμενο να χρησιμοποιήσετε το uriComponent(), αντί για encodeUriComponent()το . Αν και οι δύο λειτουργίες λειτουργούν με τον ίδιο τρόπο, uriComponent() προτιμάται.

encodeUriComponent('<value>')

Παράμετρος	Required	Τύπος	Περιγραφή
< τιμή>	Yes	Συμβλοσειρά	Η συμβολοσειρά για μετατροπή σε μορφή κωδικοποίησης URI

Τιμή επιστροφής	Τύπος	Περιγραφή
< κωδικοποιημένο-URI>	Συμβλοσειρά	Η συμβολοσειρά με κωδικοποίηση URI με χαρακτήρες escape

Παράδειγμα

Αυτό το παράδειγμα δημιουργεί μια έκδοση με κωδικοποίηση URI για αυτήν τη συμβολοσειρά:

encodeUriComponent('https://contoso.com')

Και επιστρέφει αυτό το αποτέλεσμα: "http%3A%2F%2Fcontoso.com"

αδειάζω

Ελέγξτε αν μια συλλογή είναι κενή. Επιστρέψτε true όταν η συλλογή είναι κενή ή επιστρέψτε false όταν δεν είναι κενή.

empty('<collection>')
empty([<collection>])

Παράμετρος	Required	Τύπος	Περιγραφή
< συλλογή>	Yes	Συμβολοσειρά, πίνακας ή αντικείμενο	Η συλλογή για έλεγχο

Τιμή επιστροφής	Τύπος	Περιγραφή
Σωστό ή Λάθος	Boolean	Επιστρέψτε true όταν η συλλογή είναι κενή. Επιστρέψτε false όταν δεν είναι κενή.

Παράδειγμα

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

empty('')
empty('abc')

Και επιστρέφει αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: Μεταβιβάζει μια κενή συμβολοσειρά, επομένως η συνάρτηση επιστρέφει true.
• Δεύτερο παράδειγμα: Μεταβιβάζει τη συμβολοσειρά "abc", οπότε η συνάρτηση επιστρέφει false.

τελειώνειΜε

Ελέγξτε αν μια συμβολοσειρά τελειώνει με μια συγκεκριμένη δευτερεύουσα συμβολοσειρά. Επιστρέψτε true όταν βρεθεί η δευτερεύουσα συμβολοσειρά ή επιστρέψτε false όταν δεν βρεθεί. Σε αυτήν τη λειτουργία δεν γίνεται διάκριση πεζών-κεφαλαίων.

endsWith('<text>', '<searchText>')

Παράμετρος	Required	Τύπος	Περιγραφή
< Κείμενο>	Yes	Συμβλοσειρά	Η συμβολοσειρά για έλεγχο
< αναζήτησηΚείμενο>	Yes	Συμβλοσειρά	Η τελική δευτερεύουσα συμβολοσειρά για εύρεση

Τιμή επιστροφής	Τύπος	Περιγραφή
Σωστό ή Λάθος	Boolean	Επιστρέψτε true όταν βρεθεί η τελική δευτερεύουσα συμβολοσειρά. Επιστρέψτε false όταν δεν βρέθηκε.

Παράδειγμα 1

Αυτό το παράδειγμα ελέγχει εάν η συμβολοσειρά "hello world" τελειώνει με τη συμβολοσειρά "world":

endsWith('hello world', 'world')

Και επιστρέφει αυτό το αποτέλεσμα: true

Παράδειγμα 2

Αυτό το παράδειγμα ελέγχει εάν η συμβολοσειρά "hello world" τελειώνει με τη συμβολοσειρά "universe":

endsWith('hello world', 'universe')

Και επιστρέφει αυτό το αποτέλεσμα: false

ίσον

Ελέγξτε εάν και οι δύο τιμές, παραστάσεις ή αντικείμενα είναι ισοδύναμα. Επιστρέψτε true όταν και τα δύο είναι ισοδύναμα ή επιστρέψτε false όταν δεν είναι ισοδύναμα.

equals('<object1>', '<object2>')

Παράμετρος	Required	Τύπος	Περιγραφή
< Αντικείμενο1>, Αντικείμενο2<>	Yes	Ποικίλος	Οι τιμές, οι παραστάσεις ή τα αντικείμενα προς σύγκριση

Τιμή επιστροφής	Τύπος	Περιγραφή
Σωστό ή Λάθος	Boolean	Επιστρέψτε true όταν και τα δύο είναι ισοδύναμα. Επιστρέψτε false όταν δεν είναι ισοδύναμο.

Παράδειγμα

Αυτά τα παραδείγματα ελέγχουν εάν οι καθορισμένες είσοδοι είναι ισοδύναμες.

equals(true, 1)
equals('abc', 'abcd')

Και επιστρέφει αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: Και οι δύο τιμές είναι ισοδύναμες, επομένως η συνάρτηση επιστρέφει true.
• Δεύτερο παράδειγμα: Και οι δύο τιμές δεν είναι ισοδύναμες, επομένως η συνάρτηση επιστρέφει false.

πρώτος

Επιστροφή του πρώτου στοιχείου από μια συμβολοσειρά ή πίνακα.

first('<collection>')
first([<collection>])

Παράμετρος	Required	Τύπος	Περιγραφή
< συλλογή>	Yes	Συμβολοσειρά ή πίνακας	Η συλλογή όπου θα βρείτε το πρώτο στοιχείο

Τιμή επιστροφής	Τύπος	Περιγραφή
< Πρώτο στοιχείο συλλογής>	Όποιος	Το πρώτο στοιχείο της συλλογής

Παράδειγμα

Αυτά τα παραδείγματα βρίσκουν το πρώτο στοιχείο σε αυτές τις συλλογές:

first('hello')
first(createArray(0, 1, 2))

Και επιστρέψτε αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: "h"
• Δεύτερο παράδειγμα: 0

επιπλέω

Μετατρέψτε μια έκδοση συμβολοσειράς για έναν αριθμό κινητής υποδιαστολής σε έναν πραγματικό αριθμό κινητής υποδιαστολής.

float('<value>')

Παράμετρος	Required	Τύπος	Περιγραφή
< τιμή>	Yes	Συμβλοσειρά	Η συμβολοσειρά που έχει έναν έγκυρο αριθμό κινητής υποδιαστολής για μετατροπή

Τιμή επιστροφής	Τύπος	Περιγραφή
< κυμαινόμενη αξία>	Float	Ο αριθμός κινητής υποδιαστολής για την καθορισμένη συμβολοσειρά

Παράδειγμα

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

float('10.333')

Και επιστρέφει αυτό το αποτέλεσμα: 10.333

formatDateTime

Επιστρέψτε μια χρονική σήμανση στην καθορισμένη μορφή.

formatDateTime('<timestamp>', '<format>'?)

Παράμετρος	Required	Τύπος	Περιγραφή
< Χρονική σήμανση>	Yes	Συμβλοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση
< Μορφή>	No	Συμβλοσειρά	Είτε ένα προσδιοριστικό μεμονωμένης μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-μμ-ηηTHΩ:λλ:ss.fffffffK), η οποία συμμορφώνεται με το πρότυπο ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Τιμή επιστροφής	Τύπος	Περιγραφή
< Αναμορφωμένη χρονική σήμανση>	Συμβλοσειρά	Η ενημερωμένη χρονική σήμανση στην καθορισμένη μορφή

Παράδειγμα

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

formatDateTime('03/15/2018 12:00:00', 'yyyy-MM-ddTHH:mm:ss')

Και επιστρέφει αυτό το αποτέλεσμα: "2018-03-15T12:00:00"

getFutureTime

Επιστρέψτε την τρέχουσα χρονική σήμανση συν τις καθορισμένες μονάδες χρόνου.

getFutureTime(<interval>, <timeUnit>, <format>?)

Παράμετρος	Required	Τύπος	Περιγραφή
< διάστημα>	Yes	Integer	Ο αριθμός των καθορισμένων μονάδων χρόνου που θα προστεθούν
< Μονάδα χρόνου>	Yes	Συμβλοσειρά	Η μονάδα χρόνου που χρησιμοποιείται με το διάστημα: "Δεύτερο", "Λεπτό", "Ώρα", "Ημέρα", "Εβδομάδα", "Μήνας", "Έτος"
< Μορφή>	No	Συμβλοσειρά	Είτε ένα προσδιοριστικό μεμονωμένης μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-μμ-ηηTHΩ:λλ:ss.fffffffK), η οποία συμμορφώνεται με το πρότυπο ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Τιμή επιστροφής	Τύπος	Περιγραφή
< ενημερωμένη-χρονική σήμανση>	Συμβλοσειρά	Η τρέχουσα χρονική σήμανση συν τον καθορισμένο αριθμό μονάδων χρόνου

Παράδειγμα 1

Ας υποθέσουμε ότι η τρέχουσα χρονική σήμανση είναι "2018-03-01T00:00:00.0000000Z". Αυτό το παράδειγμα προσθέτει πέντε ημέρες σε αυτήν τη χρονική σήμανση:

getFutureTime(5, 'Day')

Και επιστρέφει αυτό το αποτέλεσμα: "2018-03-06T00:00:00.0000000Z"

Παράδειγμα 2

Ας υποθέσουμε ότι η τρέχουσα χρονική σήμανση είναι "2018-03-01T00:00:00.0000000Z". Αυτό το παράδειγμα προσθέτει πέντε ημέρες και μετατρέπει το αποτέλεσμα σε μορφή "D":

getFutureTime(5, 'Day', 'D')

Και επιστρέφει αυτό το αποτέλεσμα: "Tuesday, March 6, 2018"

getPastTime

Επιστρέψτε την τρέχουσα χρονική σήμανση μείον τις καθορισμένες μονάδες χρόνου.

getPastTime(<interval>, <timeUnit>, <format>?)

Παράμετρος	Required	Τύπος	Περιγραφή
< διάστημα>	Yes	Integer	Ο αριθμός των καθορισμένων μονάδων χρόνου που θα αφαιρεθούν
< Μονάδα χρόνου>	Yes	Συμβλοσειρά	Η μονάδα χρόνου που χρησιμοποιείται με το διάστημα: "Δεύτερο", "Λεπτό", "Ώρα", "Ημέρα", "Εβδομάδα", "Μήνας", "Έτος"
< Μορφή>	No	Συμβλοσειρά	Είτε ένα προσδιοριστικό μεμονωμένης μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-μμ-ηηTHΩ:λλ:ss.fffffffK), η οποία συμμορφώνεται με το πρότυπο ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Τιμή επιστροφής	Τύπος	Περιγραφή
< ενημερωμένη-χρονική σήμανση>	Συμβλοσειρά	Η τρέχουσα χρονική σήμανση μείον τον καθορισμένο αριθμό μονάδων χρόνου

Παράδειγμα 1

Ας υποθέσουμε ότι η τρέχουσα χρονική σήμανση είναι "2018-02-01T00:00:00.00000000Z". Αυτό το παράδειγμα αφαιρεί πέντε ημέρες από αυτήν τη χρονική σήμανση:

getPastTime(5, 'Day')

Και επιστρέφει αυτό το αποτέλεσμα: "2018-01-27T00:00:00.0000000Z"

Παράδειγμα 2

Ας υποθέσουμε ότι η τρέχουσα χρονική σήμανση είναι "2018-02-01T00:00:00.00000000Z". Αυτό το παράδειγμα αφαιρεί πέντε ημέρες και μετατρέπει το αποτέλεσμα σε μορφή "D":

getPastTime(5, 'Day', 'D')

Και επιστρέφει αυτό το αποτέλεσμα: "Saturday, January 27, 2018"

μεγαλύτερη

Ελέγξτε αν η πρώτη τιμή είναι μεγαλύτερη από τη δεύτερη. Επιστρέψτε true όταν η πρώτη τιμή είναι μεγαλύτερη ή return false όταν είναι μικρότερη.

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')

Παράμετρος	Required	Τύπος	Περιγραφή
< τιμή>	Yes	Ακέραιος, κινητή ή συμβολοσειρά	Η πρώτη τιμή για να ελέγξετε αν είναι μεγαλύτερη από τη δεύτερη τιμή
< compareTo>	Yes	Ακέραιος, Float ή String, αντίστοιχα	Η τιμή σύγκρισης

Τιμή επιστροφής	Τύπος	Περιγραφή
Σωστό ή Λάθος	Boolean	Επιστρέφει true όταν η πρώτη τιμή είναι μεγαλύτερη από τη δεύτερη. Επιστρέφει false όταν η πρώτη τιμή είναι ίση ή μικρότερη από τη δεύτερη.

Παράδειγμα

Αυτά τα παραδείγματα ελέγχουν αν η πρώτη τιμή είναι μεγαλύτερη από τη δεύτερη:

greater(10, 5)
greater('apple', 'banana')

Και επιστρέψτε αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: true
• Δεύτερο παράδειγμα: false

greaterOrEquals

Ελέγξτε αν η πρώτη τιμή είναι μεγαλύτερη ή ίση με τη δεύτερη. Επιστρέφει true όταν η πρώτη τιμή είναι μεγαλύτερη ή ίση ή επιστρέφει false όταν η πρώτη τιμή είναι μικρότερη.

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')

Παράμετρος	Required	Τύπος	Περιγραφή
< τιμή>	Yes	Ακέραιος, κινητή ή συμβολοσειρά	Η πρώτη τιμή για να ελέγξετε αν είναι μεγαλύτερη ή ίση με τη δεύτερη τιμή
< compareTo>	Yes	Ακέραιος, Float ή String, αντίστοιχα	Η τιμή σύγκρισης

Τιμή επιστροφής	Τύπος	Περιγραφή
Σωστό ή Λάθος	Boolean	Επιστρέφει true όταν η πρώτη τιμή είναι μεγαλύτερη ή ίση με τη δεύτερη. Επιστρέφει false όταν η πρώτη τιμή είναι μικρότερη από τη δεύτερη.

Παράδειγμα

Αυτά τα παραδείγματα ελέγχουν εάν η πρώτη τιμή είναι μεγαλύτερη ή ίση με τη δεύτερη τιμή:

greaterOrEquals(5, 5)
greaterOrEquals('apple', 'banana')

Και επιστρέψτε αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: true
• Δεύτερο παράδειγμα: false

GUID

Δημιουργήστε ένα καθολικά μοναδικό αναγνωριστικό (GUID) ως συμβολοσειρά, για παράδειγμα, "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":

guid()

Επίσης, μπορείτε να καθορίσετε μια διαφορετική μορφή για το GUID εκτός από την προεπιλεγμένη μορφή, "D", η οποία είναι 32 ψηφία διαχωρισμένα με παύλες.

guid('<format>')

Παράμετρος	Required	Τύπος	Περιγραφή
< Μορφή>	No	Συμβλοσειρά	Ένα προσδιοριστικό μεμονωμένης μορφής για το επιστρεφόμενο GUID. Από προεπιλογή, η μορφή είναι "D", αλλά μπορείτε να χρησιμοποιήσετε "N", "D", "B", "P" ή "X".

Τιμή επιστροφής	Τύπος	Περιγραφή
< Τιμή GUID>	Συμβλοσειρά	Ένα τυχαία δημιουργημένο GUID

Παράδειγμα

Αυτό το παράδειγμα δημιουργεί το ίδιο GUID, αλλά ως 32 ψηφία, διαχωρισμένα με παύλες και μέσα σε παρενθέσεις:

guid('P')

Και επιστρέφει αυτό το αποτέλεσμα: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

αν

Ελέγξτε αν μια έκφραση είναι αληθής ή ψευδής. Με βάση το αποτέλεσμα, επιστρέψτε μια καθορισμένη τιμή.

if(<expression>, <valueIfTrue>, <valueIfFalse>)

Παράμετρος	Required	Τύπος	Περιγραφή
< έκφραση>	Yes	Boolean	Η έκφραση προς έλεγχο
< τιμήIfTrue>	Yes	Όποιος	Η τιμή που θα επιστραφεί όταν η παράσταση είναι αληθής
< τιμήIfFalse>	Yes	Όποιος	Η τιμή που θα επιστραφεί όταν η παράσταση είναι false

Τιμή επιστροφής	Τύπος	Περιγραφή
< καθορισμένη-επιστρεφόμενη-τιμή>	Όποιος	Η καθορισμένη τιμή που επιστρέφει με βάση το αν η παράσταση είναι αληθής ή ψευδής

Παράδειγμα

Αυτό το παράδειγμα επιστρέφει "yes" επειδή η καθορισμένη παράσταση επιστρέφει αληθές. Διαφορετικά, το παράδειγμα επιστρέφει "no":

if(equals(1, 1), 'yes', 'no')

indexOf

Επιστρέφει την αρχική θέση ή την τιμή ευρετηρίου για μια δευτερεύουσα συμβολοσειρά. Αυτή η συνάρτηση δεν κάνει διάκριση πεζών-κεφαλαίων και τα ευρετήρια ξεκινούν με τον αριθμό 0.

indexOf('<text>', '<searchText>')

Παράμετρος	Required	Τύπος	Περιγραφή
< Κείμενο>	Yes	Συμβλοσειρά	Η συμβολοσειρά που έχει τη δευτερεύουσα συμβολοσειρά για εύρεση
< αναζήτησηΚείμενο>	Yes	Συμβλοσειρά	Η δευτερεύουσα συμβολοσειρά για εύρεση

Τιμή επιστροφής	Τύπος	Περιγραφή
< τιμή-δείκτη>	Integer	Η αρχική θέση ή η τιμή ευρετηρίου για την καθορισμένη δευτερεύουσα συμβολοσειρά. Εάν η συμβολοσειρά δεν βρεθεί, επιστρέψτε τον αριθμό -1.

Παράδειγμα

Αυτό το παράδειγμα βρίσκει την αρχική τιμή ευρετηρίου για την υποσυμβολοσειρά "world" στη συμβολοσειρά "hello world":

indexOf('hello world', 'world')

Και επιστρέφει αυτό το αποτέλεσμα: 6

ακέραιος

Επιστρέψτε την ακέραια έκδοση για μια συμβολοσειρά.

int('<value>')

Παράμετρος	Required	Τύπος	Περιγραφή
< τιμή>	Yes	Συμβλοσειρά	Η συμβολοσειρά για μετατροπή

Τιμή επιστροφής	Τύπος	Περιγραφή
< ακέραιο αποτέλεσμα>	Integer	Η ακέραια έκδοση για την καθορισμένη συμβολοσειρά

Παράδειγμα

Αυτό το παράδειγμα δημιουργεί μια ακέραια έκδοση για τη συμβολοσειρά "10":

int('10')

Και επιστρέφει αυτό το αποτέλεσμα: 10

JSON

Επιστρέφει την τιμή τύπου JavaScript Object Notation (JSON) ή το αντικείμενο για μια συμβολοσειρά ή XML.

json('<value>')

Παράμετρος	Required	Τύπος	Περιγραφή
< τιμή>	Yes	Συμβολοσειρά ή XML	Η συμβολοσειρά ή XML για μετατροπή

Τιμή επιστροφής	Τύπος	Περιγραφή
< Αποτέλεσμα JSON>	Εγγενής τύπος ή αντικείμενο JSON	Η τιμή ή το αντικείμενο τοπικού τύπου JSON για την καθορισμένη συμβολοσειρά ή XML. Εάν η συμβολοσειρά είναι null, η συνάρτηση επιστρέφει ένα κενό αντικείμενο.

Παράδειγμα 1

Αυτό το παράδειγμα μετατρέπει αυτήν τη συμβολοσειρά στην τιμή JSON:

json('[1, 2, 3]')

Και επιστρέφει αυτό το αποτέλεσμα: [1, 2, 3]

Παράδειγμα 2

Αυτό το παράδειγμα μετατρέπει αυτήν τη συμβολοσειρά σε JSON:

json('{"fullName": "Sophia Owen"}')

Και επιστρέφει αυτό το αποτέλεσμα:

{
  "fullName": "Sophia Owen"
}

Παράδειγμα 3

Αυτό το παράδειγμα μετατρέπει αυτό το XML σε JSON:

json(xml('<?xml version="1.0"?> <root> <person id='1'> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> </root>'))

Και επιστρέφει αυτό το αποτέλεσμα:

{
   "?xml": { "@version": "1.0" },
   "root": {
      "person": [ {
         "@id": "1",
         "name": "Sophia Owen",
         "occupation": "Engineer"
      } ]
   }
}

διασταύρωση

Επιστρέψτε μια συλλογή που έχει μόνο τα κοινά στοιχεία στις καθορισμένες συλλογές. Για να εμφανιστεί στο αποτέλεσμα, ένα στοιχείο πρέπει να εμφανίζεται σε όλες τις συλλογές που μεταβιβάζονται σε αυτήν τη λειτουργία. Εάν ένα ή περισσότερα στοιχεία έχουν το ίδιο όνομα, το τελευταίο στοιχείο με αυτό το όνομα εμφανίζεται στο αποτέλεσμα.

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)

Παράμετρος	Required	Τύπος	Περιγραφή
< συλλογή1>, <συλλογή2>, ...	Yes	Πίνακας ή αντικείμενο, αλλά όχι και τα δύο	Οι συλλογές από όπου θέλετε μόνο τα κοινά στοιχεία

Τιμή επιστροφής	Τύπος	Περιγραφή
< Κοινά αντικείμενα>	Πίνακας ή αντικείμενο, αντίστοιχα	Μια συλλογή που έχει μόνο τα κοινά στοιχεία στις καθορισμένες συλλογές

Παράδειγμα

Αυτό το παράδειγμα εντοπίζει τα κοινά στοιχεία σε αυτούς τους πίνακες:

intersection(createArray(1, 2, 3), createArray(101, 2, 1, 10), createArray(6, 8, 1, 2))

Και επιστρέφει έναν πίνακα μόνο με αυτά τα στοιχεία: [1, 2]

ενώνω

Επιστρέφει μια συμβολοσειρά που έχει όλα τα στοιχεία από έναν πίνακα και έχει κάθε χαρακτήρα διαχωρισμένο με έναν οριοθέτη.

join([<collection>], '<delimiter>')

Παράμετρος	Required	Τύπος	Περιγραφή
< συλλογή>	Yes	Παράταξη	Ο πίνακας που έχει τα στοιχεία για να ενωθούν
< οριοθέτης>	Yes	Συμβλοσειρά	Το διαχωριστικό που εμφανίζεται μεταξύ κάθε χαρακτήρα στη συμβολοσειρά που προκύπτει

Τιμή επιστροφής	Τύπος	Περιγραφή
< >< Χαρ1οριοθέτης><><Χαρακ2οριοθέτης>...	Συμβλοσειρά	Η συμβολοσειρά που προκύπτει δημιουργείται από όλα τα στοιχεία στον καθορισμένο πίνακα

Παράδειγμα

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

join(createArray('a', 'b', 'c'), '.')

Και επιστρέφει αυτό το αποτέλεσμα: "a.b.c"

τελευταίος

Επιστροφή του τελευταίου στοιχείου από μια συλλογή.

last('<collection>')
last([<collection>])

Παράμετρος	Required	Τύπος	Περιγραφή
< συλλογή>	Yes	Συμβολοσειρά ή πίνακας	Η συλλογή όπου θα βρείτε το τελευταίο στοιχείο

Τιμή επιστροφής	Τύπος	Περιγραφή
< τελευταίο στοιχείο συλλογής>	Συμβολοσειρά ή πίνακας, αντίστοιχα	Το τελευταίο στοιχείο της συλλογής

Παράδειγμα

Αυτά τα παραδείγματα βρίσκουν το τελευταίο στοιχείο σε αυτές τις συλλογές:

last('abcd')
last(createArray(0, 1, 2, 3))

Και επιστρέφει αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: "d"
• Δεύτερο παράδειγμα: 3

lastIndexOf

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

lastIndexOf('<text>', '<searchText>')

Παράμετρος	Required	Τύπος	Περιγραφή
< Κείμενο>	Yes	Συμβλοσειρά	Η συμβολοσειρά που έχει τη δευτερεύουσα συμβολοσειρά για εύρεση
< αναζήτησηΚείμενο>	Yes	Συμβλοσειρά	Η δευτερεύουσα συμβολοσειρά για εύρεση

Τιμή επιστροφής	Τύπος	Περιγραφή
< τέλος-δείκτης-τιμή>	Integer	Η αρχική θέση ή η τιμή δείκτη για την τελευταία εμφάνιση της καθορισμένης δευτερεύουσας συμβολοσειράς. Εάν η συμβολοσειρά δεν βρεθεί, επιστρέψτε τον αριθμό -1.

Παράδειγμα

Αυτό το παράδειγμα βρίσκει την τιμή του αρχικού ευρετηρίου για την τελευταία εμφάνιση της δευτερεύουσας συμβολοσειράς "world" στη συμβολοσειρά "hello world":

lastIndexOf('hello world', 'world')

Και επιστρέφει αυτό το αποτέλεσμα: 6

μήκος

Επιστροφή του αριθμού των στοιχείων σε μια συλλογή.

length('<collection>')
length([<collection>])

Παράμετρος	Required	Τύπος	Περιγραφή
< συλλογή>	Yes	Συμβολοσειρά ή πίνακας	Η συλλογή με τα αντικείμενα προς καταμέτρηση

Τιμή επιστροφής	Τύπος	Περιγραφή
< μήκος-ή-πλήθος>	Integer	Ο αριθμός των αντικειμένων στη συλλογή

Παράδειγμα

Αυτά τα παραδείγματα μετρούν τον αριθμό των στοιχείων σε αυτές τις συλλογές:

length('abcd')
length(createArray(0, 1, 2, 3))

Και επιστρέψτε αυτό το αποτέλεσμα: 4

λιγότερος

Ελέγξτε αν η πρώτη τιμή είναι μικρότερη από τη δεύτερη. Επιστρέψτε true όταν η πρώτη τιμή είναι μικρότερη ή return false όταν η πρώτη τιμή είναι μεγαλύτερη.

less(<value>, <compareTo>)
less('<value>', '<compareTo>')

Παράμετρος	Required	Τύπος	Περιγραφή
< τιμή>	Yes	Ακέραιος, κινητή ή συμβολοσειρά	Η πρώτη τιμή για να ελέγξετε αν είναι μικρότερη από τη δεύτερη τιμή
< compareTo>	Yes	Ακέραιος, Float ή String, αντίστοιχα	Το στοιχείο σύγκρισης

Τιμή επιστροφής	Τύπος	Περιγραφή
Σωστό ή Λάθος	Boolean	Επιστρέφει true όταν η πρώτη τιμή είναι μικρότερη από τη δεύτερη. Επιστρέφει false όταν η πρώτη τιμή είναι ίση ή μεγαλύτερη από τη δεύτερη.

Παράδειγμα

Αυτά τα παραδείγματα ελέγχουν αν η πρώτη τιμή είναι μικρότερη από τη δεύτερη.

less(5, 10)
less('banana', 'apple')

Και επιστρέψτε αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: true
• Δεύτερο παράδειγμα: false

lessOrEquals

Ελέγξτε αν η πρώτη τιμή είναι μικρότερη ή ίση με τη δεύτερη. Επιστρέφει true όταν η πρώτη τιμή είναι μικρότερη ή ίση ή επιστρέφει false όταν η πρώτη τιμή είναι μεγαλύτερη.

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')

Παράμετρος	Required	Τύπος	Περιγραφή
< τιμή>	Yes	Ακέραιος, κινητή ή συμβολοσειρά	Η πρώτη τιμή για να ελέγξετε αν είναι μικρότερη ή ίση με τη δεύτερη τιμή
< compareTo>	Yes	Ακέραιος, Float ή String, αντίστοιχα	Το στοιχείο σύγκρισης

Τιμή επιστροφής	Τύπος	Περιγραφή
Σωστό ή Λάθος	Boolean	Επιστρέφει true όταν η πρώτη τιμή είναι μικρότερη ή ίση με τη δεύτερη. Επιστρέφει false όταν η πρώτη τιμή είναι μεγαλύτερη από τη δεύτερη.

Παράδειγμα

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

lessOrEquals(10, 10)
lessOrEquals('apply', 'apple')

Και επιστρέψτε αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: true
• Δεύτερο παράδειγμα: false

μέγ.

Επιστρέφει την υψηλότερη τιμή από μια λίστα ή πίνακα με αριθμούς που περιλαμβάνονται και στα δύο άκρα.

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])

Παράμετρος	Required	Τύπος	Περιγραφή
< αριθμός1>, <αριθμός2>, ...	Yes	Ακέραιος, Κινητή ή και τα δύο	Το σύνολο των αριθμών από τους οποίους θέλετε την υψηλότερη τιμή
[<αριθμός1>, <αριθμός2>, ...]	Yes	Πίνακας - Ακέραιος, Κινητή ή και τα δύο	Ο πίνακας αριθμών από τον οποίο θέλετε την υψηλότερη τιμή

Τιμή επιστροφής	Τύπος	Περιγραφή
< max-τιμή>	Ακέραιος ή κυμαινόμενος	Η υψηλότερη τιμή στον καθορισμένο πίνακα ή σύνολο αριθμών

Παράδειγμα

Αυτά τα παραδείγματα λαμβάνουν την υψηλότερη τιμή από το σύνολο αριθμών και τον πίνακα:

max(1, 2, 3)
max(createArray(1, 2, 3))

Και επιστρέψτε αυτό το αποτέλεσμα: 3

min

Επιστρέφει τη χαμηλότερη τιμή από ένα σύνολο αριθμών ή έναν πίνακα.

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])

Παράμετρος	Required	Τύπος	Περιγραφή
< αριθμός1>, <αριθμός2>, ...	Yes	Ακέραιος, Κινητή ή και τα δύο	Το σύνολο των αριθμών από τους οποίους θέλετε τη χαμηλότερη τιμή
[<αριθμός1>, <αριθμός2>, ...]	Yes	Πίνακας - Ακέραιος, Κινητή ή και τα δύο	Ο πίνακας αριθμών από τον οποίο θέλετε τη χαμηλότερη τιμή

Τιμή επιστροφής	Τύπος	Περιγραφή
< ελάχιστη τιμή>	Ακέραιος ή κυμαινόμενος	Η χαμηλότερη τιμή στο καθορισμένο σύνολο αριθμών ή στον καθορισμένο πίνακα

Παράδειγμα

Αυτά τα παραδείγματα λαμβάνουν τη χαμηλότερη τιμή στο σύνολο αριθμών και στον πίνακα:

min(1, 2, 3)
min(createArray(1, 2, 3))

Και επιστρέψτε αυτό το αποτέλεσμα: 1

MOD

Επιστρέψτε το υπόλοιπο από τη διαίρεση δύο αριθμών. Για να λάβετε το ακέραιο αποτέλεσμα, δείτε div().

mod(<dividend>, <divisor>)

Παράμετρος	Required	Τύπος	Περιγραφή
< μέρισμα>	Yes	Ακέραιος ή κυμαινόμενος	Ο αριθμός που θα διαιρεθεί με τον διαιρέτη
< διαιρέτης>	Yes	Ακέραιος ή κυμαινόμενος	Ο αριθμός που διαιρεί το μέρισμα, αλλά δεν μπορεί να είναι 0.

Τιμή επιστροφής	Τύπος	Περιγραφή
< modulo-αποτέλεσμα>	Ακέραιος ή κυμαινόμενος	Το υπόλοιπο από τη διαίρεση του πρώτου αριθμού με τον δεύτερο αριθμό

Παράδειγμα

Αυτό το παράδειγμα διαιρεί τον πρώτο αριθμό με τον δεύτερο αριθμό:

mod(3, 2)

Και επιστρέψτε αυτό το αποτέλεσμα: 1

mul

Επιστρέψτε το προϊόν πολλαπλασιάζοντας δύο αριθμούς.

mul(<multiplicand1>, <multiplicand2>)

Παράμετρος	Required	Τύπος	Περιγραφή
< πολλαπλασιασμός1>	Yes	Ακέραιος ή κυμαινόμενος	Ο αριθμός που θα πολλαπλασιαστεί με πολλαπλασιασμό και2
< πολλαπλασιασμός2>	Yes	Ακέραιος ή κυμαινόμενος	Ο αριθμός που πολλαπλασιάζεται και1

Τιμή επιστροφής	Τύπος	Περιγραφή
< προϊόν-αποτέλεσμα>	Ακέραιος ή κυμαινόμενος	Το γινόμενο από τον πολλαπλασιασμό του πρώτου αριθμού με τον δεύτερο αριθμό

Παράδειγμα

Αυτά τα παραδείγματα πολλαπλασιάζουν τον πρώτο αριθμό με τον δεύτερο αριθμό:

mul(1, 2)
mul(1.5, 2)

Και επιστρέψτε αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: 2
• Δεύτερο παράδειγμα 3

όχι

Ελέγξτε αν μια έκφραση είναι ψευδής. Επιστρέψτε true όταν η έκφραση είναι false ή επιστρέψτε false όταν είναι true.

not(<expression>)

Παράμετρος	Required	Τύπος	Περιγραφή
< έκφραση>	Yes	Boolean	Η έκφραση προς έλεγχο

Τιμή επιστροφής	Τύπος	Περιγραφή
Σωστό ή Λάθος	Boolean	Επιστρέψτε true όταν η παράσταση είναι false. Επιστρέψτε false όταν η έκφραση είναι αληθής.

Παράδειγμα 1

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

not(false)
not(true)

Και επιστρέψτε αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: Η έκφραση είναι false, επομένως η συνάρτηση επιστρέφει true.
• Δεύτερο παράδειγμα: Η έκφραση είναι true, επομένως η συνάρτηση επιστρέφει false.

Παράδειγμα 2

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

not(equals(1, 2))
not(equals(1, 1))

Και επιστρέψτε αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: Η έκφραση είναι false, επομένως η συνάρτηση επιστρέφει true.
• Δεύτερο παράδειγμα: Η έκφραση είναι true, επομένως η συνάρτηση επιστρέφει false.

or

Ελέγξτε αν τουλάχιστον μία έκφραση είναι αληθής. Επιστρέψτε true όταν τουλάχιστον μία έκφραση είναι αληθής ή επιστρέψτε false όταν και οι δύο είναι ψευδείς.

or(<expression1>, <expression2>)

Παράμετρος	Required	Τύπος	Περιγραφή
< έκφραση1>, <έκφραση2>	Yes	Boolean	Οι εκφράσεις προς έλεγχο

Τιμή επιστροφής	Τύπος	Περιγραφή
Σωστό ή Λάθος	Boolean	Επιστρέψτε true όταν ισχύει τουλάχιστον μία παράσταση. Επιστρέψτε false όταν και οι δύο εκφράσεις είναι false.

Παράδειγμα 1

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

or(true, false)
or(false, false)

Και επιστρέψτε αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: Τουλάχιστον μία έκφραση είναι αληθής, επομένως η συνάρτηση επιστρέφει true.
• Δεύτερο παράδειγμα: Και οι δύο εκφράσεις είναι ψευδείς, επομένως η συνάρτηση επιστρέφει false.

Παράδειγμα 2

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

or(equals(1, 1), equals(1, 2))
or(equals(1, 2), equals(1, 3))

Και επιστρέψτε αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: Τουλάχιστον μία έκφραση είναι αληθής, επομένως η συνάρτηση επιστρέφει true.
• Δεύτερο παράδειγμα: Και οι δύο εκφράσεις είναι ψευδείς, επομένως η συνάρτηση επιστρέφει false.

ραντ

Επιστρέφει έναν τυχαίο ακέραιο από μια καθορισμένη περιοχή, η οποία περιλαμβάνεται μόνο στο αρχικό τέλος.

rand(<minValue>, <maxValue>)

Παράμετρος	Required	Τύπος	Περιγραφή
< minΑξία>	Yes	Integer	Ο χαμηλότερος ακέραιος στην περιοχή
< maxValue>	Yes	Integer	Ο ακέραιος που ακολουθεί τον υψηλότερο ακέραιο στην περιοχή που μπορεί να επιστρέψει η συνάρτηση

Τιμή επιστροφής	Τύπος	Περιγραφή
< τυχαίο αποτέλεσμα>	Integer	Ο τυχαίος ακέραιος επέστρεψε από το καθορισμένο εύρος

Παράδειγμα

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

rand(1, 5)

Και επιστρέφει έναν από αυτούς τους αριθμούς ως αποτέλεσμα: 1, 2, 3, ή 4

έκταση

Επιστρέφει έναν ακέραιο πίνακα που ξεκινά από έναν καθορισμένο ακέραιο.

range(<startIndex>, <count>)

Παράμετρος	Required	Τύπος	Περιγραφή
< startIndex>	Yes	Integer	Μια ακέραια τιμή που ξεκινά τον πίνακα ως το πρώτο στοιχείο
< μετρώ>	Yes	Integer	Ο αριθμός των ακεραίων στον πίνακα

Τιμή επιστροφής	Τύπος	Περιγραφή
[<εύρος-αποτέλεσμα>]	Παράταξη	Ο πίνακας με ακέραιους αριθμούς που ξεκινούν από τον καθορισμένο δείκτη

Παράδειγμα

Αυτό το παράδειγμα δημιουργεί έναν πίνακα ακεραίων που ξεκινά από το καθορισμένο ευρετήριο και έχει τον καθορισμένο αριθμό ακεραίων:

range(1, 4)

Και επιστρέφει αυτό το αποτέλεσμα: [1, 2, 3, 4]

αντικαθιστώ

Αντικαταστήστε μια δευτερεύουσα συμβολοσειρά με την καθορισμένη συμβολοσειρά και επιστρέψτε τη συμβολοσειρά αποτελεσμάτων. Αυτή η λειτουργία κάνει διάκριση πεζών-κεφαλαίων.

replace('<text>', '<oldText>', '<newText>')

Παράμετρος	Required	Τύπος	Περιγραφή
< Κείμενο>	Yes	Συμβλοσειρά	Η συμβολοσειρά που έχει τη δευτερεύουσα συμβολοσειρά προς αντικατάσταση
< παλιόΚείμενο>	Yes	Συμβλοσειρά	Η δευτερεύουσα συμβολοσειρά προς αντικατάσταση
< νέοΚείμενο>	Yes	Συμβλοσειρά	Η συμβολοσειρά αντικατάστασης

Τιμή επιστροφής	Τύπος	Περιγραφή
< ενημερωμένο κείμενο>	Συμβλοσειρά	Η ενημερωμένη συμβολοσειρά μετά την αντικατάσταση της δευτερεύουσας συμβολοσειράς Εάν η δευτερεύουσα συμβολοσειρά δεν βρεθεί, επιστρέψτε την αρχική συμβολοσειρά.

Παράδειγμα

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

replace('the old string', 'old', 'new')

Και επιστρέφει αυτό το αποτέλεσμα: "the new string"

πήδημα

Καταργήστε στοιχεία από το μπροστινό μέρος μιας συλλογής και επιστρέψτε όλα τα άλλα στοιχεία.

skip([<collection>], <count>)

Παράμετρος	Required	Τύπος	Περιγραφή
< συλλογή>	Yes	Παράταξη	Η συλλογή της οποίας τα στοιχεία θέλετε να καταργήσετε
< μετρώ>	Yes	Integer	Ένας θετικός ακέραιος για τον αριθμό των στοιχείων που πρέπει να αφαιρεθούν στο μπροστινό μέρος

Τιμή επιστροφής	Τύπος	Περιγραφή
[<ενημέρωση-συλλογή>]	Παράταξη	Η ενημερωμένη συλλογή μετά την αφαίρεση των καθορισμένων στοιχείων

Παράδειγμα

Αυτό το παράδειγμα καταργεί ένα στοιχείο, τον αριθμό 0, από το μπροστινό μέρος του καθορισμένου πίνακα:

skip(createArray(0, 1, 2, 3), 1)

Και επιστρέφει αυτόν τον πίνακα με τα υπόλοιπα στοιχεία: [1,2,3]

χωρίζω

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

split('<text>', '<delimiter>')

Παράμετρος	Required	Τύπος	Περιγραφή
< Κείμενο>	Yes	Συμβλοσειρά	Η συμβολοσειρά που θα διαχωριστεί σε δευτερεύουσες συμβολοσειρές με βάση τον καθορισμένο οριοθέτη στην αρχική συμβολοσειρά
< οριοθέτης>	Yes	Συμβλοσειρά	Ο χαρακτήρας στην αρχική συμβολοσειρά που θα χρησιμοποιηθεί ως οριοθέτης

Τιμή επιστροφής	Τύπος	Περιγραφή
[<Δευτερεύουσα συμβολοσειρά1>;Δευτερεύουσα<συμβολοσειρά2>,...]	Παράταξη	Ένας πίνακας που περιέχει δευτερεύουσες συμβολοσειρές από την αρχική συμβολοσειρά, διαχωρισμένες με κόμματα

Παράδειγμα

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

split('a_b_c', '_')

Και επιστρέφει αυτόν τον πίνακα ως αποτέλεσμα: ["a","b","c"]

startOfDay

Επιστρέψτε την έναρξη της ημέρας για μια χρονική σήμανση.

startOfDay('<timestamp>', '<format>'?)

Παράμετρος	Required	Τύπος	Περιγραφή
< Χρονική σήμανση>	Yes	Συμβλοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση
< Μορφή>	No	Συμβλοσειρά	Είτε ένα προσδιοριστικό μεμονωμένης μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-μμ-ηηTHΩ:λλ:ss.fffffffK), η οποία συμμορφώνεται με το πρότυπο ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Τιμή επιστροφής	Τύπος	Περιγραφή
< ενημερωμένη-χρονική σήμανση>	Συμβλοσειρά	Η καθορισμένη χρονική σήμανση, αλλά ξεκινώντας από το σημάδι μηδενικής ώρας για την ημέρα

Παράδειγμα

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

startOfDay('2018-03-15T13:30:30Z')

Και επιστρέφει αυτό το αποτέλεσμα: "2018-03-15T00:00:00.0000000Z"

startOfHour

Επιστρέψτε την έναρξη της ώρας για μια χρονική σήμανση.

startOfHour('<timestamp>', '<format>'?)

Παράμετρος	Required	Τύπος	Περιγραφή
< Χρονική σήμανση>	Yes	Συμβλοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση
< Μορφή>	No	Συμβλοσειρά	Είτε ένα προσδιοριστικό μεμονωμένης μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-μμ-ηηTHΩ:λλ:ss.fffffffK), η οποία συμμορφώνεται με το πρότυπο ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Τιμή επιστροφής	Τύπος	Περιγραφή
< ενημερωμένη-χρονική σήμανση>	Συμβλοσειρά	Η καθορισμένη χρονική σήμανση, αλλά ξεκινώντας από το σημάδι μηδέν λεπτών για την ώρα

Παράδειγμα

Αυτό το παράδειγμα βρίσκει την αρχή της ώρας για αυτήν τη χρονική σήμανση:

startOfHour('2018-03-15T13:30:30Z')

Και επιστρέφει αυτό το αποτέλεσμα: "2018-03-15T13:00:00.0000000Z"

startOfMonth

Επιστρέψτε την αρχή του μήνα για μια χρονική σήμανση.

startOfMonth('<timestamp>', '<format>'?)

Παράμετρος	Required	Τύπος	Περιγραφή
< Χρονική σήμανση>	Yes	Συμβλοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση
< Μορφή>	No	Συμβλοσειρά	Είτε ένα προσδιοριστικό μεμονωμένης μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-μμ-ηηTHΩ:λλ:ss.fffffffK), η οποία συμμορφώνεται με το πρότυπο ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Τιμή επιστροφής	Τύπος	Περιγραφή
< ενημερωμένη-χρονική σήμανση>	Συμβλοσειρά	Η καθορισμένη χρονική σήμανση, αλλά ξεκινώντας από την πρώτη ημέρα του μήνα στο σημάδι μηδενικής ώρας

Παράδειγμα

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

startOfMonth('2018-03-15T13:30:30Z')

Και επιστρέφει αυτό το αποτέλεσμα: "2018-03-01T00:00:00.0000000Z"

ξεκινάΜε

Ελέγξτε αν μια συμβολοσειρά ξεκινά με μια συγκεκριμένη δευτερεύουσα συμβολοσειρά. Επιστρέψτε true όταν βρεθεί η δευτερεύουσα συμβολοσειρά ή επιστρέψτε false όταν δεν βρεθεί. Σε αυτήν τη λειτουργία δεν γίνεται διάκριση πεζών-κεφαλαίων.

startsWith('<text>', '<searchText>')

Παράμετρος	Required	Τύπος	Περιγραφή
< Κείμενο>	Yes	Συμβλοσειρά	Η συμβολοσειρά για έλεγχο
< αναζήτησηΚείμενο>	Yes	Συμβλοσειρά	Η αρχική συμβολοσειρά για εύρεση

Τιμή επιστροφής	Τύπος	Περιγραφή
Σωστό ή Λάθος	Boolean	Επιστρέψτε true όταν βρεθεί η αρχική δευτερεύουσα συμβολοσειρά. Επιστρέψτε false όταν δεν βρέθηκε.

Παράδειγμα 1

Αυτό το παράδειγμα ελέγχει αν η συμβολοσειρά "hello world" ξεκινά με τη δευτερεύουσα συμβολοσειρά "hello":

startsWith('hello world', 'hello')

Και επιστρέφει αυτό το αποτέλεσμα: true

Παράδειγμα 2

Αυτό το παράδειγμα ελέγχει αν η συμβολοσειρά "hello world" ξεκινά με τη δευτερεύουσα συμβολοσειρά "χαιρετισμούς":

startsWith('hello world', 'greetings')

Και επιστρέφει αυτό το αποτέλεσμα: false

string

Επιστρέψτε την έκδοση συμβολοσειράς για μια τιμή.

string(<value>)

Παράμετρος	Required	Τύπος	Περιγραφή
< τιμή>	Yes	Όποιος	Η τιμή προς μετατροπή

Τιμή επιστροφής	Τύπος	Περιγραφή
< συμβολοσειρά-τιμή>	Συμβλοσειρά	Η έκδοση συμβολοσειράς για την καθορισμένη τιμή

Παράδειγμα 1

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

string(10)

Και επιστρέφει αυτό το αποτέλεσμα: "10"

Παράδειγμα 2

Αυτό το παράδειγμα δημιουργεί μια συμβολοσειρά για το καθορισμένο αντικείμενο JSON και χρησιμοποιεί την ανάστροφη κάθετο (\) ως χαρακτήρα escape για τα διπλά εισαγωγικά (").

string( { "name": "Sophie Owen" } )

Και επιστρέφει αυτό το αποτέλεσμα: "{ \\"name\\": \\"Sophie Owen\\" }"

επιμέρους

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

sub(<minuend>, <subtrahend>)

Παράμετρος	Required	Τύπος	Περιγραφή
< minuend>	Yes	Ακέραιος ή κυμαινόμενος	Ο αριθμός από τον οποίο θα αφαιρεθεί το subtrahend
< Αφαιρετέος>	Yes	Ακέραιος ή κυμαινόμενος	Ο αριθμός που πρέπει να αφαιρεθεί από το minuend

Τιμή επιστροφής	Τύπος	Περιγραφή
< αποτέλεσμα>	Ακέραιος ή κυμαινόμενος	Το αποτέλεσμα από την αφαίρεση του δεύτερου αριθμού από τον πρώτο αριθμό

Παράδειγμα

Αυτό το παράδειγμα αφαιρεί τον δεύτερο αριθμό από τον πρώτο:

sub(10.3, .3)

Και επιστρέφει αυτό το αποτέλεσμα: 10

Δευτερεύουσα συμβολοσειρά

Επιστροφή χαρακτήρων από μια συμβολοσειρά, ξεκινώντας από την καθορισμένη θέση ή ευρετήριο. Οι τιμές ευρετηρίου ξεκινούν με τον αριθμό 0.

substring('<text>', <startIndex>, <length>)

Παράμετρος	Required	Τύπος	Περιγραφή
< Κείμενο>	Yes	Συμβλοσειρά	Η συμβολοσειρά της οποίας τους χαρακτήρες θέλετε
< startIndex>	Yes	Integer	Ένας θετικός αριθμός ίσος ή μεγαλύτερος από 0 που θέλετε να χρησιμοποιήσετε ως αρχική θέση ή τιμή δείκτη
< μήκος>	Yes	Integer	Ένας θετικός αριθμός χαρακτήρων που θέλετε στη δευτερεύουσα συμβολοσειρά

Τιμή επιστροφής	Τύπος	Περιγραφή
< Δευτερεύουσα συμβολοσειρά-αποτέλεσμα>	Συμβλοσειρά	Μια δευτερεύουσα συμβολοσειρά με τον καθορισμένο αριθμό χαρακτήρων, ξεκινώντας από την καθορισμένη θέση ευρετηρίου στη συμβολοσειρά προέλευσης

Παράδειγμα

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

substring('hello world', 6, 5)

Και επιστρέφει αυτό το αποτέλεσμα: "world"

αφαιρείΑπόΏρα

Αφαιρέστε έναν αριθμό μονάδων χρόνου από μια χρονική σήμανση. Δείτε επίσης getPastTime.

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)

Παράμετρος	Required	Τύπος	Περιγραφή
< Χρονική σήμανση>	Yes	Συμβλοσειρά	Η συμβολοσειρά που περιέχει τη χρονική σήμανση
< διάστημα>	Yes	Integer	Ο αριθμός των καθορισμένων μονάδων χρόνου που θα αφαιρεθούν
< Μονάδα χρόνου>	Yes	Συμβλοσειρά	Η μονάδα χρόνου που χρησιμοποιείται με το διάστημα: "Δεύτερο", "Λεπτό", "Ώρα", "Ημέρα", "Εβδομάδα", "Μήνας", "Έτος"
< Μορφή>	No	Συμβλοσειρά	Είτε ένα προσδιοριστικό μεμονωμένης μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-μμ-ηηTHΩ:λλ:ss.fffffffK), η οποία συμμορφώνεται με το πρότυπο ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Τιμή επιστροφής	Τύπος	Περιγραφή
< ενημερωμένη-χρονική σήμανση>	Συμβλοσειρά	Η χρονική σήμανση μείον τον καθορισμένο αριθμό μονάδων χρόνου

Παράδειγμα 1

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

subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day')

Και επιστρέφει αυτό το αποτέλεσμα: "2018-01-01T00:00:00:0000000Z"

Παράδειγμα 2

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

subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day', 'D')

Και επιστρέφει αυτό το αποτέλεσμα χρησιμοποιώντας την προαιρετική μορφή "D": "Monday, January, 1, 2018"

παίρνω

Επιστροφή στοιχείων από το μπροστινό μέρος μιας συλλογής.

take('<collection>', <count>)
take([<collection>], <count>)

Παράμετρος	Required	Τύπος	Περιγραφή
< συλλογή>	Yes	Συμβολοσειρά ή πίνακας	Η συλλογή της οποίας τα αντικείμενα θέλετε
< μετρώ>	Yes	Integer	Ένας θετικός ακέραιος για τον αριθμό των στοιχείων που θέλετε από μπροστά

Τιμή επιστροφής	Τύπος	Περιγραφή
< υποσύνολο> ή [<υποσύνολο>]	Συμβολοσειρά ή πίνακας, αντίστοιχα	Μια συμβολοσειρά ή ένας πίνακας που έχει τον καθορισμένο αριθμό στοιχείων που έχουν ληφθεί από το μπροστινό μέρος της αρχικής συλλογής

Παράδειγμα

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

take('abcde', 3)
take(createArray(0, 1, 2, 3, 4), 3)

Και επιστρέψτε αυτά τα αποτελέσματα:

• Πρώτο παράδειγμα: "abc"
• Δεύτερο παράδειγμα: [0, 1, 2]

Κρότωνες

Επιστρέφει την τιμή ιδιότητας ticks για μια καθορισμένη χρονική σήμανση. Ένα τσιμπούρι είναι ένα διάστημα 100 νανοδευτερολέπτων.

ticks('<timestamp>')

Παράμετρος	Required	Τύπος	Περιγραφή
< Χρονική σήμανση>	Yes	Συμβλοσειρά	Η συμβολοσειρά για μια χρονική σήμανση

Τιμή επιστροφής	Τύπος	Περιγραφή
< κρότωνες-αριθμός>	Integer	Ο αριθμός των τσιμπουριών που έχουν παρέλθει από τις 12:00:00 τα μεσάνυχτα, 1 Ιανουαρίου 0001 στο Γρηγοριανό ημερολόγιο από τη χρονική σήμανση εισαγωγής

προςΚάτω

Επιστρέψτε μια συμβολοσειρά με πεζά γράμματα. Εάν ένας χαρακτήρας στη συμβολοσειρά δεν έχει έκδοση με πεζά γράμματα, αυτός ο χαρακτήρας παραμένει αμετάβλητος στη συμβολοσειρά που επιστρέφεται.

toLower('<text>')

Παράμετρος	Required	Τύπος	Περιγραφή
< Κείμενο>	Yes	Συμβλοσειρά	Η συμβολοσειρά που θα επιστρέψει σε πεζή μορφή

Τιμή επιστροφής	Τύπος	Περιγραφή
< πεζό κείμενο>	Συμβλοσειρά	Η αρχική συμβολοσειρά σε πεζή μορφή

Παράδειγμα

Αυτό το παράδειγμα μετατρέπει αυτήν τη συμβολοσειρά σε πεζά:

toLower('Hello World')

Και επιστρέφει αυτό το αποτέλεσμα: "hello world"

έωςΆνω

Επιστρέψτε μια συμβολοσειρά σε κεφαλαία μορφή. Εάν ένας χαρακτήρας στη συμβολοσειρά δεν έχει έκδοση με κεφαλαία, αυτός ο χαρακτήρας παραμένει αμετάβλητος στη συμβολοσειρά που επιστρέφεται.

toUpper('<text>')

Παράμετρος	Required	Τύπος	Περιγραφή
< Κείμενο>	Yes	Συμβλοσειρά	Η συμβολοσειρά που θα επιστρέψει σε κεφαλαία μορφή

Τιμή επιστροφής	Τύπος	Περιγραφή
< κεφαλαίο-κείμενο>	Συμβλοσειρά	Η αρχική συμβολοσειρά σε κεφαλαία μορφή

Παράδειγμα

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

toUpper('Hello World')

Και επιστρέφει αυτό το αποτέλεσμα: "HELLO WORLD"

τάξη

Καταργήστε το αρχικό και το τελικό κενό διάστημα από μια συμβολοσειρά και επιστρέψτε την ενημερωμένη συμβολοσειρά.

trim('<text>')

Παράμετρος	Required	Τύπος	Περιγραφή
< Κείμενο>	Yes	Συμβλοσειρά	Η συμβολοσειρά που έχει το αρχικό και το τελικό κενό διάστημα για κατάργηση

Τιμή επιστροφής	Τύπος	Περιγραφή
< ενημέρωσηΚείμενο>	Συμβλοσειρά	Μια ενημερωμένη έκδοση για την αρχική συμβολοσειρά χωρίς κενό διάστημα στην αρχή ή στο τέλος

Παράδειγμα

Αυτό το παράδειγμα καταργεί το αρχικό και το τελικό κενό διάστημα από τη συμβολοσειρά " Hello World ":

trim(' Hello World  ')

Και επιστρέφει αυτό το αποτέλεσμα: "Hello World"

ένωση

Επιστρέψτε μια συλλογή που περιέχει όλα τα στοιχεία από τις καθορισμένες συλλογές. Για να εμφανιστεί στο αποτέλεσμα, ένα στοιχείο μπορεί να εμφανιστεί σε οποιαδήποτε συλλογή περάσει σε αυτήν τη λειτουργία. Εάν ένα ή περισσότερα στοιχεία έχουν το ίδιο όνομα, το τελευταίο στοιχείο με αυτό το όνομα εμφανίζεται στο αποτέλεσμα.

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)

Παράμετρος	Required	Τύπος	Περιγραφή
< συλλογή1>, <συλλογή2>, ...	Yes	Πίνακας ή αντικείμενο, αλλά όχι και τα δύο	Οι συλλογές από όπου θέλετε όλα τα στοιχεία

Τιμή επιστροφής	Τύπος	Περιγραφή
< updatedΣυλλογή>	Πίνακας ή αντικείμενο, αντίστοιχα	Μια συλλογή με όλα τα στοιχεία από τις καθορισμένες συλλογές - χωρίς διπλότυπα

Παράδειγμα

Αυτό το παράδειγμα λαμβάνει όλα τα στοιχεία από αυτές τις συλλογές:

union(createArray(1, 2, 3), createArray(1, 2, 10, 101))

Και επιστρέφει αυτό το αποτέλεσμα: [1, 2, 3, 10, 101]

uriComponent

Επιστρέψτε μια κωδικοποιημένη έκδοση ενιαίου αναγνωριστικού πόρου (URI) για μια συμβολοσειρά, αντικαθιστώντας τους μη ασφαλείς χαρακτήρες URL με χαρακτήρες escape. Χρησιμοποιήστε αυτήν τη συνάρτηση αντί για encodeUriComponent(). Αν και οι δύο λειτουργίες λειτουργούν με τον ίδιο τρόπο, uriComponent() προτιμάται.

uriComponent('<value>')

Παράμετρος	Required	Τύπος	Περιγραφή
< τιμή>	Yes	Συμβλοσειρά	Η συμβολοσειρά για μετατροπή σε μορφή κωδικοποίησης URI

Τιμή επιστροφής	Τύπος	Περιγραφή
< κωδικοποιημένο-URI>	Συμβλοσειρά	Η συμβολοσειρά με κωδικοποίηση URI με χαρακτήρες escape

Παράδειγμα

Αυτό το παράδειγμα δημιουργεί μια έκδοση με κωδικοποίηση URI για αυτήν τη συμβολοσειρά:

uriComponent('https://contoso.com')

Και επιστρέφει αυτό το αποτέλεσμα: "http%3A%2F%2Fcontoso.com"

uriComponentToBinary

Επιστρέψτε τη δυαδική έκδοση για ένα στοιχείο ενιαίου αναγνωριστικού πόρου (URI).

uriComponentToBinary('<value>')

Παράμετρος	Required	Τύπος	Περιγραφή
< τιμή>	Yes	Συμβλοσειρά	Η συμβολοσειρά με κωδικοποίηση URI για μετατροπή

Τιμή επιστροφής	Τύπος	Περιγραφή
< δυαδικό-για-κωδικοποιημένο-uri>	Συμβλοσειρά	Η δυαδική έκδοση για τη συμβολοσειρά με κωδικοποίηση URI. Το δυαδικό περιεχόμενο είναι κωδικοποιημένο με βάση 64 και αντιπροσωπεύεται από $contentτο .

Παράδειγμα

Αυτό το παράδειγμα δημιουργεί τη δυαδική έκδοση για αυτήν τη συμβολοσειρά με κωδικοποίηση URI:

uriComponentToBinary('http%3A%2F%2Fcontoso.com')

Και επιστρέφει αυτό το αποτέλεσμα:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

Επιστρέψτε την έκδοση συμβολοσειράς για μια συμβολοσειρά με κωδικοποίηση ενιαίου αναγνωριστικού πόρου (URI), αποκωδικοποιώντας αποτελεσματικά τη συμβολοσειρά με κωδικοποίηση URI.

uriComponentToString('<value>')

Παράμετρος	Required	Τύπος	Περιγραφή
< τιμή>	Yes	Συμβλοσειρά	Η συμβολοσειρά με κωδικοποίηση URI για αποκωδικοποίηση

Τιμή επιστροφής	Τύπος	Περιγραφή
< αποκωδικοποιημένο-URI>	Συμβλοσειρά	Η αποκωδικοποιημένη έκδοση για τη συμβολοσειρά με κωδικοποίηση URI

Παράδειγμα

Αυτό το παράδειγμα δημιουργεί την έκδοση αποκωδικοποιημένης συμβολοσειράς για αυτήν τη συμβολοσειρά με κωδικοποίηση URI:

uriComponentToString('http%3A%2F%2Fcontoso.com')

Και επιστρέφει αυτό το αποτέλεσμα: "https://contoso.com"

utcNow

Επιστρέψτε την τρέχουσα χρονική σήμανση.

utcNow('<format>')

Προαιρετικά, μπορείτε να καθορίσετε διαφορετική μορφή με την < παράμετρο μορφοποίησης>.

Παράμετρος	Required	Τύπος	Περιγραφή
< Μορφή>	No	Συμβλοσειρά	Είτε ένα προσδιοριστικό μεμονωμένης μορφής είτε ένα προσαρμοσμένο μοτίβο μορφής. Η προεπιλεγμένη μορφή για τη χρονική σήμανση είναι "o" (εεεε-μμ-ηηTHΩ:λλ:ss.fffffffK), η οποία συμμορφώνεται με το πρότυπο ISO 8601 και διατηρεί τις πληροφορίες ζώνης ώρας.

Τιμή επιστροφής	Τύπος	Περιγραφή
< τρέχουσα χρονική σήμανση>	Συμβλοσειρά	Η τρέχουσα ημερομηνία και ώρα

Παράδειγμα 1

Ας υποθέσουμε ότι σήμερα είναι 15 Απριλίου 2018 στις 1:00:00 μ.μ. Αυτό το παράδειγμα λαμβάνει την τρέχουσα χρονική σήμανση:

utcNow()

Και επιστρέφει αυτό το αποτέλεσμα: "2018-04-15T13:00:00.0000000Z"

Παράδειγμα 2

Ας υποθέσουμε ότι σήμερα είναι 15 Απριλίου 2018 στις 1:00:00 μ.μ. Αυτό το παράδειγμα λαμβάνει την τρέχουσα χρονική σήμανση χρησιμοποιώντας την προαιρετική μορφή "D":

utcNow('D')

Και επιστρέφει αυτό το αποτέλεσμα: "Sunday, April 15, 2018"

xml

Επιστρέψτε την έκδοση XML για μια συμβολοσειρά που περιέχει ένα αντικείμενο JSON.

xml('<value>')

Παράμετρος	Required	Τύπος	Περιγραφή
< τιμή>	Yes	Συμβλοσειρά	Η συμβολοσειρά με το αντικείμενο JSON για μετατροπή Το αντικείμενο JSON πρέπει να έχει μόνο μία ιδιότητα ρίζας, η οποία δεν μπορεί να είναι πίνακας. Χρησιμοποιήστε την ανάστροφη κάθετο (\) ως χαρακτήρα escape για τα διπλά εισαγωγικά (").

Τιμή επιστροφής	Τύπος	Περιγραφή
< XML έκδοση>	Object	Η κωδικοποιημένη XML για την καθορισμένη συμβολοσειρά ή αντικείμενο JSON

Παράδειγμα 1

Αυτό το παράδειγμα δημιουργεί την έκδοση XML για αυτήν τη συμβολοσειρά, η οποία περιέχει ένα αντικείμενο JSON:

xml(json('{ \"name\": \"Sophia Owen\" }'))

Και επιστρέφει αυτό το αποτέλεσμα XML:

<name>Sophia Owen</name>

Παράδειγμα 2

Ας υποθέσουμε ότι έχετε αυτό το αντικείμενο JSON:

{
  "person": {
    "name": "Sophia Owen",
    "city": "Seattle"
  }
}

Αυτό το παράδειγμα δημιουργεί XML για μια συμβολοσειρά που περιέχει αυτό το αντικείμενο JSON:

xml(json('{\"person\": {\"name\": \"Sophia Owen\", \"city\": \"Seattle\"}}'))

Και επιστρέφει αυτό το αποτέλεσμα XML:

<person>
  <name>Sophia Owen</name>
  <city>Seattle</city>
<person>

xPath

Ελέγξτε XML για κόμβους ή τιμές που ταιριάζουν με μια έκφραση XPath (XML Path Language) και επιστρέψτε τους κόμβους ή τις τιμές που ταιριάζουν. Μια έκφραση XPath, ή απλώς "XPath", σας βοηθά να περιηγηθείτε σε μια δομή εγγράφου XML, ώστε να μπορείτε να επιλέξετε κόμβους ή να υπολογίσετε τιμές στο περιεχόμενο XML.

xpath('<xml>', '<xpath>')

Παράμετρος	Required	Τύπος	Περιγραφή
< xml>	Yes	Όποιος	Η συμβολοσειρά XML για την αναζήτηση κόμβων ή τιμών που ταιριάζουν με μια τιμή έκφρασης XPath
< xPath>	Yes	Όποιος	Η έκφραση XPath που χρησιμοποιείται για την εύρεση κόμβων ή τιμών XML που ταιριάζουν

Τιμή επιστροφής	Τύπος	Περιγραφή
< xml-κόμβος>	XML	Ένας κόμβος XML όταν μόνο ένας κόμβος ταιριάζει με την καθορισμένη παράσταση XPath
< τιμή>	Όποιος	Η τιμή από έναν κόμβο XML όταν μόνο μία τιμή ταιριάζει με την καθορισμένη παράσταση XPath
[<xml-κόμβος1>, <xml-κόμβος2>, ...] -ή- [<τιμή1>, <τιμή2>; ...]	Παράταξη	Ένας πίνακας με κόμβους XML ή τιμές που ταιριάζουν με την καθορισμένη έκφραση XPath

Παράδειγμα 1

Ακολουθώντας το παράδειγμα 1, αυτό το παράδειγμα βρίσκει κόμβους που ταιριάζουν με τον <count></count> κόμβο και προσθέτει αυτές τις τιμές κόμβου με τη sum() συνάρτηση:

xpath(xml(parameters('items')), 'sum(/produce/item/count)')

Και επιστρέφει αυτό το αποτέλεσμα: 30

Παράδειγμα 2

Για αυτό το παράδειγμα, και οι δύο εκφράσεις βρίσκουν κόμβους που ταιριάζουν με τον <location></location> κόμβο, στα καθορισμένα ορίσματα, τα οποία περιλαμβάνουν XML με χώρο ονομάτων. Οι εκφράσεις χρησιμοποιούν την ανάστροφη κάθετο (\) ως χαρακτήρα escape για τα διπλά εισαγωγικά (").

• Έκφραση 1

  xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')

• Έκφραση 2

  xpath(xml(body('Http')), '/*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]')

Εδώ είναι τα επιχειρήματα:

• Αυτή η XML, η οποία περιλαμβάνει το χώρο ονομάτων εγγράφου XML, xmlns="http://contoso.com":

  <?xml version="1.0"?> <file xmlns="http://contoso.com"> <location>Paris</location> </file>
  

• Είτε έκφραση XPath εδώ:

  • /*[name()=\"file\"]/*[name()=\"location\"]

  • /*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]

Εδώ είναι ο κόμβος αποτελεσμάτων που ταιριάζει με τον <location></location> κόμβο:

<location xmlns="https://contoso.com">Paris</location>

Παράδειγμα 3

Ακολουθώντας το παράδειγμα 3, αυτό το <location></location> παράδειγμα βρίσκει την τιμή στον κόμβο:

xpath(xml(body('Http')), 'string(/*[name()=\"file\"]/*[name()=\"location\"])')

Και επιστρέφει αυτό το αποτέλεσμα: "Paris"

Σημείωμα

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

Σχετικό περιεχόμενο

Για οδηγίες σχετικά με τη γενική χρήση παραμέτρων, ανατρέξτε στην ενότητα Παράμετροι για το Data Factory in Fabric