Calculators · Gutenberg
Date Difference block for WordPress
Calculate the exact difference between two dates — years, months, days, total days, weeks, hours, and working days.
Get Blockenberg
Free Gutenberg block in Blockenberg. The inspector controls and front-end behavior on this page come from this block’s source, not a shared stub.
What it actually does
Calculate the exact difference between two dates — years, months, days, total days, weeks, hours, and working days.
Inspector panels on this block: Content, Display, Sizing. Those titles come from index.js, not from a shared template.
Where to find it
Gutenberg inserter → Calculators → search “Date Difference” (block name `blockenberg/date-difference` in block.json). Style it in the sidebar after insert.
How to use Date Difference block for WordPress
- Install Blockenberg. Install from WordPress.org and activate the plugin.
- Insert the block. Edit a page, click +, search for “Date Difference”, insert it. Category: Calculators.
- Configure inspector controls that exist on this block. Open Content. Set “Content — Title”, “Show title”, “Subtitle”, “Show subtitle”.
- Check the published page. The view script reads HTML data attributes: data-opts. The block editor preview may not run the same view script.
Inspector controls from this block’s code
| Control | What the code does |
|---|---|
| Content — Title | Text field in the inspector. block.json default: Date Difference Calculator. Saved as `title`. |
| Show title | On/off toggle in the inspector. On by default. Saved as `showTitle`. |
| Subtitle | Text field in the inspector. block.json default: Find the exact duration between two dates.. Saved as `subtitle`. |
| Show subtitle | On/off toggle in the inspector. On by default. Saved as `showSubtitle`. |
| From label | Text field in the inspector. block.json default: From Date. Saved as `labelFrom`. |
| To label | Text field in the inspector. block.json default: To Date. Saved as `labelTo`. |
| Show swap button | On/off toggle in the inspector. On by default. Saved as `showSwapBtn`. |
| Years / months / days | On/off toggle in the inspector. On by default. Saved as `showYMD`. |
| Total days | On/off toggle in the inspector. On by default. Saved as `showTotalDays`. |
| Total weeks | On/off toggle in the inspector. On by default. Saved as `showWeeks`. |
| Total hours | On/off toggle in the inspector. Off by default. Saved as `showHours`. |
| Total minutes | On/off toggle in the inspector. Off by default. Saved as `showMinutes`. |
| Working days (Mon–Fri) | On/off toggle in the inspector. On by default. Saved as `showWorkingDays`. |
| Typography — Title | Shared Blockenberg typography popover (family, size, weight, spacing). Saved as `typoTitle`. |
| Subtitle (Typo Subtitle) | Shared Blockenberg typography popover (family, size, weight, spacing). Saved as `typoSubtitle`. |
| Number | Shared Blockenberg typography popover (family, size, weight, spacing). Saved as `typoNumber`. |
| Stat label size | Numeric range control in the inspector. Range 9–16. block.json default: 11. Saved as `statLabelFontSize`. |
| Stat unit size | Numeric range control in the inspector. Range 9–16. block.json default: 12. Saved as `statUnitFontSize`. |
| Input label size | Numeric range control in the inspector. Range 10–18. block.json default: 13. Saved as `inputLabelFontSize`. |
| Accent | Color control in the inspector. block.json default: #6c3fb5. Saved as `accentColor`. |
| Card background | Color control in the inspector. block.json default: #ffffff. Saved as `cardBg`. |
| Result background | Color control in the inspector. block.json default: #f5f3ff. Saved as `resultBg`. |
| Result border | Color control in the inspector. block.json default: #ede9fe. Saved as `resultBorder`. |
| YMD number | Color control in the inspector. block.json default: #6c3fb5. Saved as `ymdColor`. |
| Total days | Color control in the inspector. block.json default: #3b82f6. Saved as `daysColor`. |
| Weeks | Color control in the inspector. block.json default: #10b981. Saved as `weeksColor`. |
| Hours | Color control in the inspector. block.json default: #f59e0b. Saved as `hoursColor`. |
| Working days | Color control in the inspector. block.json default: #ef4444. Saved as `wdaysColor`. |
| Colors — Title | Color control in the inspector. block.json default: #1e1b4b. Saved as `titleColor`. |
| Subtitle | Color control in the inspector. block.json default: #6b7280. Saved as `subtitleColor`. |
| Max width (px) | Numeric range control in the inspector. Range 300–900. block.json default: 620. Saved as `maxWidth`. |
| Padding top | Numeric range control in the inspector. Range 0–120. block.json default: 60. Saved as `paddingTop`. |
| Padding bottom | Numeric range control in the inspector. Range 0–120. block.json default: 60. Saved as `paddingBottom`. |
| Card radius (px) | Numeric range control in the inspector. Range 0–32. block.json default: 16. Saved as `cardRadius`. |
| Input radius (px) | Numeric range control in the inspector. Range 0–20. block.json default: 8. Saved as `inputRadius`. |
What the front-end script actually does
- The view script reads HTML data attributes: data-opts.
When this is the right block
- Calculate the exact difference between two dates — years, months, days, total days, weeks, hours, and working days — that is the job of Date Difference, not a generic content block.
- Use it when you need the editor control labeled “Content — Title”, which exists on this block’s inspector.
- It matches pages about date, difference, days.
- Inserter grouping: tools, lead magnets, and interactive widgets.
Notes from the implementation
viewScript: this folder’s frontend.js is enqueued on the front end for this block.
FAQ
How do I add the Date Difference block in WordPress?
Install Blockenberg from WordPress.org, edit a page in the block editor, click +, and search for “Date Difference”. It sits under Calculators. After insert, open Content and set “Content — Title”, “Show title”, “Subtitle”, “Show subtitle”.
Does Date Difference need a server or extra plugin?
No. After Blockenberg is active, the view script runs in the browser with the values you saved on the block.
Is the Date Difference Gutenberg block free?
Yes. Date Difference ships inside Blockenberg. Get the plugin from WordPress.org — no paid add-on is required for this block.
Can I style Date Difference to match my theme?
Yes. Blockenberg’s shared typography and color panels apply here, plus any block-specific style controls listed on this page (panels: Content, Display, Sizing).
Related calculators blocks
Age Calculator
An interactive age calculator that computes exact age in years, months, and days from a birth date. Includes next birthday countdown, total days lived, zodiac sign, and day of week born.
Time Duration Calculator
Add or subtract time durations in hours, minutes and seconds. Shows result broken down into multiple units.
Aspect Ratio Calculator
Calculate image or video dimensions, aspect ratios, and common presets for designers.
BMI Calculator
Interactive Body Mass Index calculator with metric and imperial units, animated result gauge, weight category indicator, and fully customizable styling.
Body Fat Calculator
Calculate body fat percentage using the US Navy method based on height, neck, waist, and hip measurements. Shows body fat category and health range.
Break-Even Calculator
Calculate break-even point, profit zone, and contribution margin for business analysis.
Get Blockenberg
Install Blockenberg from WordPress.org, then insert Date Difference from the Gutenberg inserter.