RESOURCES.md

Resources for Working with Dates in Salesforce and JavaScript

This is a curated list of resources designed to help you become a more confident developer when working with dates. This resource list was compiled for my theater session at Dreamforce 2022.

It's a Date(time): A Courtship with JavaScript & Salesforce
Working with Dates and Datetimes in Salesforce and JavaScript can get complicated. Learn the edge cases involved in working on the Salesforce Platform in a date- and time-driven global application.

Table of contents

• JavaScript Date Resources

  • Guides and Documentation

  • Date Libraries

  • Additional JavaScript Resources

• Salesforce Date Resources

  • Declarative Features

  • Apex, SOQL, and APIs

  • User Interface

  • Additional Salesforce Resources

• Date and Time Standards

JavaScript Date Resources

Guides and Documentation

• MDN - JavaScript Guide - Date Object

• MDN - JavaScript Built-in Objects - Date Object

• ECMAScript Language Specification - Date Object

• MDN - JavaScript Built-in Objects - Intl Object

• ECMAScript Language Specification - Intl Object

• ECMA TC39 Temporal Proposal: A proposal for a new Date/Time API for JavaScript

Date Libraries

Below are some popular JavaScript date libraries (not an exhaustive list).

• Day.js

• date-fns

• Luxon

• Moment.js: Note: Moment.js is now in maintenance mode, however, many legacy projects use this library

Additional JavaScript Resources

• JavaScript for impatient programmers: Date Chapter

• UTC is enough for everyone ... right? - Zach Holman

• Everything You Need to Know about Date in JavaScript - CSS Tricks

• The Definitive Guide to DateTime Manipulation - Toptal

• Date and time - javascript.info

Salesforce Date Resources

Declarative Features

Setting Up Your Org

• Select Your Language, Locale, and Currency

• Supported Time Zones

• Supported Date and Time Formats (ICU)

• Custom Code and Locale Format Changes

Forumla Fields

• Using Date, Date/Time, and Time Values in Formulas

• Sample Date Formulas

• Use Date, Date/Time, and Time Formulas Trailhead

Validation Rules

• Sample Date Validation Rules

Apex, SOQL, and APIs

Apex Reference Guide

• Primitive Data Types

• Date Class

• Datetime Class

• TimeZone Class

SOQL and SOSL Reference

• Date Functions

• Converting Time Zones in Date Functions

• Date Formats and Date Literals in WHERE Clauses

REST API Developer Guide

• Valid Date and DateTime Formats

User Interface

Lightning Web Components Developer Guide

• Formatted Date Time Base Component

• Relative Date Time Base Component

• Access Internationalization Properties

• Use Third-Party JavaScript Libraries: Follow this guide if you want to use a date library with your LWC

Lightning Aura Components Developer Guide

• Localization

• Formatting Dates in JavaScript

Visualforce Developer Guide

• Understanding Date and Time Serialization

Additional Salesforce Resources

• What every Salesforce developer should know about Dates and Times in Apex - Medium post

• All about Date and Time in Salesforce - SFDC Notes blog post

Date and Time Standards

• ISO 8601 - Wikipedia

• ISO 8601 - iso.org

• tz database: Also known as the IANA timezone database or Olson database