AppAlloy Documentation
Home
  • Glossary
  • 🚀Getting Started
    • Introduce AppAlloy Documentation
    • Build your first AppAlloy app
    • From sheet to app
  • 🗃️Data management
    • Learn data structure
    • Set up data source
      • Integrate with Google Sheets
      • Integrate with Microsoft Excel
      • Build Alloy table
      • Upload local file
    • Manage data type
    • Ultimate guide for data sheet
  • ⚒️Manage table views
    • Design Record View
    • Design Actions
      • Update current record
      • Delete current record
      • Delete many records
      • Create record
      • Open external URL
      • HTTP Request
      • Open phone call popup
      • Open SMS Popup
      • Open email popup
      • Send notification
    • Design Record Components
      • Plain Text
      • Phone number
      • Email
      • URL
      • Map
      • Barcode
      • Checkbox
      • Number
      • Currency
      • Rating
      • Voting
      • Date time
      • Relative date
      • Count Down / Count Up
      • Single Photo
      • Photo Gallery
      • Carousel
      • Audio Player
      • Video Player
      • Youtube Player
      • Vimeo Player
    • Design Form View
    • Design Form fields (synced tables)
      • Text (for synced tables)
      • Number (for synced tables)
      • Date time (for synced tables)
      • Checkbox (for synced table)
      • Options (for synced table)
      • Photos (for synced table)
      • Files (for synced table)
      • Table lookup (for synced table)
      • Signature (for synced table)
    • Design Form fields (Alloy tables)
      • Single line Text (for Alloy table)
      • Long Text (for Alloy table)
      • Phone number (for Alloy table)
      • Email (for Alloy table)
      • Barcode (for Alloy table)
      • Number (for Alloy table)
      • Currency (for Alloy table)
      • Checkbox (for Alloy table)
      • Date (for Alloy table)
      • Photos (for Alloy table)
      • Files (for Alloy table)
      • Single select (for Alloy table)
      • Multiple select (for Alloy table)
      • Address (for Alloy table)
      • Table lookup (for Alloy table)
  • 🎨Manage pages
    • Manage page types
    • Design 'View From' Page
    • Page Layouts
      • List Layout
      • Grid Layout
      • Card Layout
      • Map Layout
      • Checklist Layout
      • Calendar Layout
      • Kanban Layout
    • Design Canvas View Page
    • Canvas Charts
      • Line chart
      • Area Chart
      • Pie Chart
      • Donut Chart
      • Column chart vs. Stacked Column chart
      • Bar chart vs. Stacked bar chart
      • Table
    • Design Form of... Page
  • ⚙️Manage workflow
    • Introduce Workflow
    • Design a workflow
  • 🔌Manage Integration
    • Manage AppAlloy Integration
    • Manage Slack Integration
    • Manage Gmail Integration
    • Manage Google Drive Integration
    • Manage Google Calendar integration
  • 📱Manage App Settings
    • Manage app appearance
  • 🌎App distribution
    • Publish your app
    • Use app as Mobile Web app
    • Use app on AppAlloy Air
  • 🚹Account, team, and plan
    • Manage Account
    • Manage Apps
    • Manage Users
    • Manage Plans
    • Manage Teams
  • #️⃣Learn Power FX
    • Introduce Power FX
    • Operators & Identifiers
    • Formula References
      • Average
      • Concatenate
      • Date
      • DateAdd
      • DateDiff
      • DateValue
      • DateTimeValue
      • Day
      • If
      • Month
      • Now
      • Rand
      • RandBetween
      • Round
      • RoundDown
      • RoundUp
      • Sum
      • Text
      • Today
      • Weeknum
      • Weekday
      • Year
Powered by GitBook
On this page
  • Syntax
  • Example
  • Table
  • Requirement
  • Formula
  • Result

Was this helpful?

  1. Learn Power FX
  2. Formula References

DateDiff

calculates the difference between two dates

The DateDiff function in Power FX calculates the difference between two dates. It returns the number of days, months, or years between the two specified dates.

Syntax

The basic syntax in Power FX is:

DateDiff(ThisItem.ColumnStartDate, ThisItem.ColumnEndDate, TimeUnit.[Unit])

However

In AppAlloy, your DateTime data is ISO 8601 formatted which is different from the format of DateTime that works with PowerFX.

Therefore, use DateValue or DateTimeValueto convert the DateTime data.

Then, the complete syntax is:

  • If data includes Date only

DateDiff(DateValue(ThisItem.ColumnStartDate), DateValue(ThisItem.ColumnEndDate), TimeUnit.[Unit]))
  • if data includes Date and Time

DateDiff(DateTimeValue(ThisItem.ColumnStartDate), DateTimeValue(ThisItem.ColumnEndDate), TimeUnit.[Unit]))

In which:

ThisItem.ColumnStartDate: The column contains the data of the start date. If the heading has any special characters, keep the headings in brackets. For example: ThisItem.'Start Date'.

ThisItem.ColumnEndDate: The column contains the data of the end date. If the headings has any special characters, keep the headings in brackets. For example: ThisItem.'End Date'.

TimeUnit.[Unit]: (Optional) The type of Units to subtract including TimeUnit.Milliseconds, TimeUnit.Seconds, TimeUnit.Minutes, TimeUnit.Hours, TimeUnit.Days, TimeUnit.Months, TimeUnit.Quarters, or TimeUnit.Years. If not specified, TimeUnit.Days are used.

Example

Table

Let’s say you have a table to track your Projects with columns of StartDate and EndDate.

Requirement

Calculate how long it has taken to complete each task, unit "day(s)".

Formula

DateDiff(DateTimeValue(ThisItem.'Start Date'), DateTimeValue(ThisItem.'End Date'),TimeUnit.Days)

Result

If the formula and data are correct, you can see the value of column when you set to view it in the app.

Last updated 7 months ago

Was this helpful?

#️⃣