VCOF0047

OmniFocus: Add (1-7) Day(s) to Deferment Date

This Voice Control command will push the due date of the selected task or project the specified number of days (1-6). NOTE: The time is not effected, just the date.

Scope and Syntax

Language: English (United States 🇺🇸 · Great Britain 🇬🇧 · Australia 🇦🇺 · Canada 🇨🇦) • Scope: OmniFocus

Command phrase variations (words in [brackets] are optional):

NOTE: the terms “deferment” and “deferred” are used in place of “defer” as the later may be not recognized correctly by the speech recognition frameworks.

One day:

• “Add One Day to Deferment Date”
• “Add One Day to Deferred Date”
• “Push [Out] Deferment Date [by] One Day”
• “Add One Day to Date Deferred”
• “Push [Out] Date Deferred [by] One Day”

Multiple days (2-6):

• “Add Two Days to Deferment Date”
• “Add Two Days to Deferred Date”
• “Push [Out] Deferment Date [by] Two Days”
• “Add Two Days to Date Deferred”
• “Push [Out] Date Deferred [by] Two Days”

Requirements

• Application: OmniFocus 4
• System: macOS 12.3, iOS 15, iPadOS 15, visionOS 1.0

Downloads

• ⇩ COMMANDS-FILE OmniFocus 4.0 (macOS)
• ⇩ SHORTCUT-LINK (“Add 1-Day to Deferment Date”) (iOS · iPadOS · visionOS)
• ⇩ SHORTCUT-LINK (“Add 2-Days to Deferment Date”) (iOS · iPadOS · visionOS)
• ⇩ SHORTCUT-LINK (“Add 3-Days to Deferment Date”) (iOS · iPadOS · visionOS)
• ⇩ SHORTCUT-LINK (“Add 4-Days to Deferment Date”) (iOS · iPadOS · visionOS)
• ⇩ SHORTCUT-LINK (“Add 5-Days to Deferment Date”) (iOS · iPadOS · visionOS)
• ⇩ SHORTCUT-LINK (“Add 6-Days to Deferment Date”) (iOS · iPadOS · visionOS)
• ⇩ SHORTCUT-LINK (“Add 7-Days to Deferment Date”) (iOS · iPadOS · visionOS)

Voice Command Code

Here’s the Omni Automation code for the command.

Add One Day to Deferment Date
Copy

(async () => {
	try {
		function createUtterance(textToSpeak){
			langCode = Speech.Voice.currentLanguageCode
			voiceObj = Speech.Voice.withLanguage(langCode)
			utterance = new Speech.Utterance(textToSpeak)
			utterance.voice = voiceObj
			utterance.rate = Speech.Utterance.defaultSpeechRate
			return utterance
		}
		synthesizer = new Speech.Synthesizer()

		sel = document.windows[0].selection
		selCount = sel.tasks.length + sel.projects.length 
		if(selCount === 1){
			if (sel.tasks.length === 1){
				var selectedItem = sel.tasks[0]
				var objType = "task"
			} else {
				var selectedItem = sel.projects[0]
				var objType = "project"
			}
		} else {
			throw {
				name: "Selection Issue", 
				message: "Please select a single project or task."
			}
		}
		if (!selectedItem.deferDate){
			throw {
				name:"Missing Value", 
				message: "The selected project or task has no assigned deferment date."
			}
		}
		daysToPush = 1
		dc = Calendar.current.dateComponentsFromDate(selectedItem.deferDate)
		dc.day = dc.day + daysToPush
		newDate = Calendar.current.dateFromDateComponents(dc)
		selectedItem.deferDate = newDate
		
		dateString = Formatter.Date.withFormat('h:mma, EEEE, LLLL d').stringFromDate(newDate)
		//--> "12:07AM, Wednesday, March 2"
		response = `The ${objType} is now deferred until ${dateString}`
		utterance = createUtterance(response)
		synthesizer.speakUtterance(utterance)
	}
	catch(err){
		utterance = createUtterance(err.message)
		synthesizer.speakUtterance(utterance)
		//new Alert(err.name, err.message).show()
	}
})();