{"id":31486,"date":"2018-04-21T15:47:47","date_gmt":"2018-04-21T15:47:47","guid":{"rendered":"https:\/\/ampscript.guide\/datediff\/"},"modified":"2021-04-06T00:58:37","modified_gmt":"2021-04-06T00:58:37","slug":"datediff","status":"publish","type":"post","link":"https:\/\/ampscript.guide\/datediff\/","title":{"rendered":"DateDiff"},"content":{"rendered":"<h2>DateDiff<\/h2>\n<p>This function returns the difference between two dates based on the specified date part.<\/p>\n<h3>Arguments<\/h3>\n<p><code>DateDiff(1,2,3)<\/code><\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: center\">Ordinal<\/th>\n<th style=\"text-align: left\">Type<\/th>\n<th style=\"text-align: left\">Required<\/th>\n<th style=\"text-align: left\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: center\">1<\/td>\n<td style=\"text-align: left\">Date<\/td>\n<td style=\"text-align: left\">True<\/td>\n<td style=\"text-align: left\">The start date from which to subtract<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: center\">2<\/td>\n<td style=\"text-align: left\">Date<\/td>\n<td style=\"text-align: left\">True<\/td>\n<td style=\"text-align: left\">The date to subtract from the start date<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: center\">3<\/td>\n<td style=\"text-align: left\">String<\/td>\n<td style=\"text-align: left\">True<\/td>\n<td style=\"text-align: left\">The part of the date to adjust. Valid values include <code>Y<\/code>, <code>M<\/code>, <code>D<\/code>, <code>H<\/code>, and <code>MI<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3>Example<\/h3>\n<pre><code>%%[\n\nvar @startDate, @endDate, @diffYear, @diffMonth, @diffDay, @diffHours, @diffMinutes\nset @startDate = '2016-08-15 6:30 AM'\nset @endDate = '2017-10-16 8:31 AM'\nset @diffYear = dateDiff(@startDate, @endDate,\"Y\")\nset @diffMonth = dateDiff(@startDate, @endDate,\"M\")\nset @diffDay = dateDiff(@startDate, @endDate,\"D\")\nset @diffHours = dateDiff(@startDate, @endDate,\"H\")\nset @diffMinutes = dateDiff(@startDate, @endDate,\"MI\")\n\n]%%\nstartDate: %%=v(@startDate)=%%\n&lt;br&gt;endDate: %%=v(@endDate)=%%\n&lt;br&gt;diffYear: %%=v(@diffYear)=%%\n&lt;br&gt;diffMonth: %%=v(@diffMonth)=%%\n&lt;br&gt;diffDay: %%=v(@diffDay)=%%\n&lt;br&gt;diffHours: %%=v(@diffHours)=%%\n&lt;br&gt;diffMinutes: %%=v(@diffMinutes)=%%<\/code><\/pre>\n<h4>Output<\/h4>\n<pre><code>startDate: 2016-08-15 6:30 AM\nendDate: 2017-10-16 8:31 AM\ndiffYear: 1\ndiffMonth: 14\ndiffDay: 427\ndiffHours: 10250\ndiffMinutes: 615001<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"<p>DateDiff This function returns the difference between two dates based on the specified date part. Arguments DateDiff(1,2,3) Ordinal Type Required Description 1 Date True The start date from which to subtract 2 Date True The date to subtract from the start date 3 String True The part of the date to adjust. Valid values include [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":[],"categories":[1],"tags":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v14.7 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>The AMPscript Guide - DateDiff<\/title>\n<meta name=\"robots\" content=\"index, follow\" \/>\n<meta name=\"googlebot\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<meta name=\"bingbot\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/ampscript.guide\/datediff\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"The AMPscript Guide - DateDiff\" \/>\n<meta property=\"og:description\" content=\"DateDiff This function returns the difference between two dates based on the specified date part. Arguments DateDiff(1,2,3) Ordinal Type Required Description 1 Date True The start date from which to subtract 2 Date True The date to subtract from the start date 3 String True The part of the date to adjust. Valid values include [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/ampscript.guide\/datediff\/\" \/>\n<meta property=\"og:site_name\" content=\"The AMPscript Guide\" \/>\n<meta property=\"article:published_time\" content=\"2018-04-21T15:47:47+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2021-04-06T00:58:37+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebSite\",\"@id\":\"https:\/\/ampscript.guide\/#website\",\"url\":\"https:\/\/ampscript.guide\/\",\"name\":\"The AMPscript Guide\",\"description\":\"The Definitive Scripting Manual for Salesforce Marketing Cloud\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":\"https:\/\/ampscript.guide\/?s={search_term_string}\",\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/ampscript.guide\/datediff\/#webpage\",\"url\":\"https:\/\/ampscript.guide\/datediff\/\",\"name\":\"The AMPscript Guide - DateDiff\",\"isPartOf\":{\"@id\":\"https:\/\/ampscript.guide\/#website\"},\"datePublished\":\"2018-04-21T15:47:47+00:00\",\"dateModified\":\"2021-04-06T00:58:37+00:00\",\"author\":{\"@id\":\"https:\/\/ampscript.guide\/#\/schema\/person\/5335042f77731e84f9808aecef25daec\"},\"breadcrumb\":{\"@id\":\"https:\/\/ampscript.guide\/datediff\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/ampscript.guide\/datediff\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/ampscript.guide\/datediff\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"item\":{\"@type\":\"WebPage\",\"@id\":\"https:\/\/ampscript.guide\/\",\"url\":\"https:\/\/ampscript.guide\/\",\"name\":\"Home\"}},{\"@type\":\"ListItem\",\"position\":2,\"item\":{\"@type\":\"WebPage\",\"@id\":\"https:\/\/ampscript.guide\/datediff\/\",\"url\":\"https:\/\/ampscript.guide\/datediff\/\",\"name\":\"DateDiff\"}}]},{\"@type\":[\"Person\"],\"@id\":\"https:\/\/ampscript.guide\/#\/schema\/person\/5335042f77731e84f9808aecef25daec\",\"name\":\"dev\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","_links":{"self":[{"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/posts\/31486"}],"collection":[{"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/comments?post=31486"}],"version-history":[{"count":0,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/posts\/31486\/revisions"}],"wp:attachment":[{"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/media?parent=31486"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/categories?post=31486"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ampscript.guide\/wp-json\/wp\/v2\/tags?post=31486"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}