Gabungkan tanggal dan waktu ke dalam perilaku aplikasi Anda.Tanggal dan waktu ekspresi menggunakan tanggal atau Durasi nilai untuk menghasilkan DateTime , tanggal , waktu , Durasi , atau Nomor nilai.
Ketentuan AppSheet bukan pertandingan satu-ke-satu dengan fungsi Google Spreadsheet; namun, dalam beberapa kasus, kesamaan format dapat membantu Anda membuat ekspresi. Atau, jika pemformatan tidak serupa, halaman fungsi Google Spreadsheet dapat menyediakan konteks untuk penggunaan fungsi. Jika tersedia, lihat tautan fungsi Google Spreadsheet dalam tanda kurung di samping operator yang berlaku.
Fungsi
- NOW() untuk DateTime saat ini pada perangkat pengguna ( SEKARANG )
- TODAY() untuk Tanggal saat ini di perangkat pengguna ( HARI INI )
- TIMENOW() untuk Waktu saat ini pada perangkat pengguna ( TIME ). Nilai-nilai dikembalikan oleh SEKARANG () , HARI INI () , dan TIMENOW () mencerminkan offset zona waktu dari perangkat pengguna. Misalnya, jika zona waktu perangkat pengguna adalah Waktu Standar Pasifik (PST), nilai yang dikembalikan adalah UTC-08: 00; jika zona waktu perangkat pengguna adalah Hong Kong, nilai yang dikembalikan adalah UTC + 8: 00. Ketika perangkat pengguna menghubungi server untuk membaca atau memperbarui data, perangkat tersebut menyertakan zona waktunya dengan permintaan tersebut. Server menggunakan zona waktu perangkat pengguna saat melakukan perhitungan waktu dan tanggal. Misalnya, ketika server mengevaluasi filter keamanan dan aturan alur kerja yang mencakup tanggal dan waktu.
- HOUR ( durasi ) untuk komponen jam dari Durasi tertentu ( JAM )
- MINUTE ( durasi ) untuk komponen menit dari Durasi tertentu ( MINUTE )
- SECOND ( durasi ) untuk komponen kedua dari Durasi tertentu ( SECOND )
- DAY ( tanggal ) untuk hari bulan ( HARI )
- MONTH ( tanggal ) untuk nomor bulan dari Tanggal ( BULAN )
- YEAR ( tanggal ) untuk tahun dari Tanggal ( YEAR )
- WEEKDAY ( tanggal ) untuk nomor hari dari Tanggal ( WEEKDAY )
- WEEKNUM ( tanggal ) untuk nomor minggu dari Tanggal ( WEEKNUM )
- WORKDAY ( tanggal , angka ) mengembalikan tanggal beberapa hari, mengabaikan akhir pekan ( WORKDAY )
Nilai yang dikembalikan oleh WEEKNUM () mengasumsikan minggu dimulai pada hari Minggu dan berakhir pada hari Sabtu. Untuk mendapatkan nomor minggu ketika minggu dimulai pada hari Senin dan berakhir pada hari Minggu, gunakan ekspresi berikut:
IF(AND(MONTH([Tanggal]) = 1, Day ([Tanggal]) = 1), 1, WEEKNUM ([Tanggal] - 1))
Operator Legacy
Untuk kompatibilitas mundur, kami juga mendukung sintaks fungsi di bawah ini untuk sekumpulan fungsi yang telah didukung dari rilis AppSheet yang paling awal.
- @ (_ NOW) untuk DateTime saat ini ( SEKARANG )
- @ (_ TODAY) untuk Tanggal saat ini ( HARI INI )
- @ (_ TIMENOW) untuk Waktu saat ini ( TIME )
Ekspresi Umum dan Kompleks
Ekspresi Umum
- TODAY() + 1 : menambahkan 1 hari ke tanggal saat ini.
- NOW() - 1 : kurangi 1 hari dari tanggal waktu saat ini.
- TODAY() - "12/30/2001" : mengembalikan Durasi antara dua nilai Tanggal .
- IF(([StopTime]> [StartTime]), ([StopTime] - [StartTime]), (([StopTime] + 24) - [StartTime])) : mengembalikan Durasi antara dua nilai Waktu .
- TIMENOW () + "03:03:00" : menambahkan 3 jam 3 menit ke waktu saat ini.
- AND ([Date]> = TODAY () - 7, [Tanggal] <= TODAY ()) ; mengembalikan true jika Tanggal dalam tujuh hari terakhir.
Ekspresi Kompleks
- @ (_ TODAY)> ([TargetDate] + 1) : memeriksa apakah [TargetDate] sudah lebih dari satu hari.
- AND(TRUE, IN (MINUTE ([_ THIS] - "00:00:00"), LIST (0, 15, 30, 45))) : memastikan bahwa nilai menit jatuh pada seperempat jam, yaitu 00, 15 , 30, atau 45.
- [ChangeTimestamp]> (SEKARANG () - 1) : memeriksa apakah DateTime dalam 1 hari dari tanggal waktu saat ini. Dalam hal ini ekspresi memeriksa nilai kolom ChangeTimestamp , tetapi ekspresi ini juga berfungsi untuk nilai kolom DateTime normal .
- [LastUpdatedDateTime]> SEKARANG () - "003: 30: 00" : memeriksa apakah DateTime berada dalam 3 jam dan 30 menit dari waktu tanggal saat ini. Dalam hal ini ekspresi memeriksa nilai kolom DateTime , tetapi ekspresi ini berfungsi untuk kolom ChangeTimestamp juga.
- HOUR (HARI INI () - [TargetDate]) / 24 : jumlah hari sejak [TargetDate] .
- [TargetDate] + ([TargetTime] - "00:00:00") : menambahkan [TargetTime] dan [TargetDate] .
- FLOOR ((JAM ([EndDate] - [StartDate])) / (365.24 * 24.0)) : jumlah tahun antara tanggal mulai dan tanggal akhir.
- FLOOR (((JAM ([EndDate] - [StartDate])) - ([Tahun] * 365,25 * 24,0)) / (30,4 * 24,0)) : jumlah bulan antara tanggal mulai dan akhir. Ini mengasumsikan kolom virtual Tahun berisi jumlah tahun yang dihitung menggunakan rumus di atas.
- FLOOR (((JAM ([EndDate] - [StartDate])) - (([Tahun] * 365,24 * 24,0) + ([Bulan] * 30,4 * 24,0))) / 24,0) : jumlah hari antara awal dan tanggal akhir. Ini mengasumsikan kolom virtual Tahun dan Bulan berisi jumlah tahun dan bulan, masing-masing, dihitung dengan menggunakan rumus di atas.
- TODAY () - (WEEKDAY (TODAY ()) - 1) : Mengembalikan tanggal dari hari Minggu sebelumnya.
- TODAY () - (WEEKDAY (TODAY ()) - 2) : Mengembalikan tanggal dari hari Senin sebelumnya.
Perhatikan bahwa ketika tanggal digunakan sebagai nilai konstan dalam ekspresi, tanggal harus diwakili dalam format MM / DD / YYYY. Ini tidak berarti data spreadsheet Anda harus menggunakan tanggal dalam format ini: representasi tanggal di spreadsheet Anda ditentukan oleh lokal / bahasa spreadsheet.
Pola Ekspresi Waktu, Hasil, dan Contoh
Dalam Pembuat Ekspresi, ikuti pola di bawah ini untuk hasil DateTime , Tanggal , Waktu , Durasi, atau Nomor . Lihat hasil dan contoh untuk kejelasan lebih lanjut.
Contoh Hasil Pola
SEKARANG () DateTime NOW ()
HARI INI () Tanggal HARI INI ()
TIMENOW () Waktu TIMENOW ()
HOUR ({Duration}] Number HOUR ([Durasi])
MINUTE ({Duration}] Number MINUTE ([Durasi])
SECOND ({Duration}] Number SECOND ([Durasi])
DAY ({Date}] Number DAY ([Tanggal])
MONTH ({Date}] Number MONTH ([Tanggal])
YEAR ({Date}] Number YEAR ([Tanggal])
WEEKDAY ({Date}] Number WEEKDAY ([Tanggal])
WEEKNUM ({Date}] Number WEEKNUM ([Tanggal])
{value_1} + {number} Tanggal [Tanggal] + 1
{value_1} - {value_2} Durasi [Tanggal] - (HARI INI () + 1)
{value_1} - {duration} Tanggal [Tanggal] - "002: 00: 00"
{value_1} - {number} DateTime [DateTime] - 1
{value_1} - {value_2} Durasi [DateTime] - (SEKARANG () +1)
{value_1} + {duration} DateTime [DateTime] - (SEKARANG () +1)
{value_1} + {number} Durasi [Durasi] + 1
{value_1} - {value_2} Durasi [Durasi] - (0:00:00 + 1)
{value_1} - {duration} Durasi [Durasi] - "002: 00: 00"
{value_1} - {number} Waktu [Waktu] - 1
{value_1} - {value_2} Durasi [Waktu] - (TIMENOW () + 1)
{value_1} + {duration} Waktu [Waktu] + "002: 00: 00"
