{"id":48059,"date":"2021-01-29T12:56:41","date_gmt":"2021-01-29T19:56:41","guid":{"rendered":"https:\/\/ephesoft.com\/docs\/?p=48059"},"modified":"2021-12-10T07:15:14","modified_gmt":"2021-12-10T14:15:14","slug":"kb00021170-format-conversion","status":"publish","type":"post","link":"https:\/\/ephesoft.com\/docs\/kb00021170-format-conversion\/","title":{"rendered":"Format Conversion Shows Incorrect Year for Certain Dates in 2020"},"content":{"rendered":"<p><span style=\"color: #333333\"><strong>Applies to: <\/strong>All versions of Ephesoft Transact<\/span><\/p>\n<h2><span style=\"color: #333333\"><a id=\"post-48059-_n05lysweei3b\" style=\"color: #333333\"><\/a>Issue<\/span><\/h2>\n<p><span style=\"color: #333333\">When creating <strong>Format Conversion <\/strong>rules to modify dates, you may experience unexpected behavior with converted years. Specifically, certain days at the end of December may be incorrectly converted to the wrong year.<\/span><\/p>\n<p><span style=\"color: #333333\">For example, the sample value of &#8220;12\/30\/2020&#8221; may be converted to &#8220;12\/30\/2021&#8221;.<\/span><\/p>\n<h2><span style=\"color: #333333\"><a id=\"post-48059-_3oeuxvga6ewe\" style=\"color: #333333\"><\/a>Root Cause<\/span><\/h2>\n<p><span style=\"color: #333333\">The year can have different values depending on using lowercase or uppercase in your <strong>Format Conversion <\/strong>rule, which affects how the rule defines a year.<\/span><\/p>\n<ul>\n<li><span style=\"color: #333333\">Lowercase &#8220;y&#8221; is the day-based year<\/span><\/li>\n<li><span style=\"color: #333333\">Uppercase &#8220;Y&#8221; is the week-based year<\/span><\/li>\n<\/ul>\n<p><span style=\"color: #333333\">This difference may cause your rules to execute correctly except for when dealing with dates at the very end of some years. <\/span><span style=\"color: #333333\">This is illustrated in the following example:<\/span><\/p>\n<p><span style=\"color: #333333\">For the date &#8220;12\/31\/2020&#8221; (December 31, 2020), using &#8220;YYYY&#8221; will incorrectly output 2021.<\/span><\/p>\n<figure id=\"attachment_48060\" aria-describedby=\"caption-attachment-48060\" style=\"width: 840px\" class=\"wp-caption alignnone\"><img decoding=\"async\" class=\"wp-image-48060 size-large\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2021\/01\/word-image-4-1024x412.png\" alt=\"\" width=\"840\" height=\"338\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2021\/01\/word-image-4-1024x412.png 1024w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2021\/01\/word-image-4-300x121.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2021\/01\/word-image-4-768x309.png 768w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2021\/01\/word-image-4.png 1434w\" sizes=\"(max-width: 840px) 100vw, 840px\" \/><figcaption id=\"caption-attachment-48060\" class=\"wp-caption-text\"><em>Figure 1. Uppercase Y in Format Conversion Rule<\/em><\/figcaption><\/figure>\n<p><span style=\"color: #333333\">However, using &#8220;yyyy&#8221; for the same date will correctly output 2020.<\/span><\/p>\n<figure id=\"attachment_48061\" aria-describedby=\"caption-attachment-48061\" style=\"width: 840px\" class=\"wp-caption alignnone\"><img decoding=\"async\" class=\"wp-image-48061 size-large\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2021\/01\/word-image-5-1024x372.png\" alt=\"\" width=\"840\" height=\"305\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2021\/01\/word-image-5-1024x372.png 1024w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2021\/01\/word-image-5-300x109.png 300w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2021\/01\/word-image-5-768x279.png 768w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2021\/01\/word-image-5-1536x558.png 1536w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2021\/01\/word-image-5.png 1565w\" sizes=\"(max-width: 840px) 100vw, 840px\" \/><figcaption id=\"caption-attachment-48061\" class=\"wp-caption-text\"><em>Figure 2. Lowercase y in Format Conversion Rule<\/em><\/figcaption><\/figure>\n<p><span style=\"color: #333333\">This is because December 31, 2020, is also in the first week of 2021.<\/span><\/p>\n<h2><span style=\"color: #333333\"><a id=\"post-48059-_1jtougactvn\" style=\"color: #333333\"><\/a>Solution<\/span><\/h2>\n<p><span style=\"color: #333333\">To prevent this issue, Ephesoft recommends always using the lowercase &#8220;y&#8221; for years in your <strong>Format Conversion <\/strong>rules.<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Applies to: All versions of Ephesoft Transact Issue When creating Format Conversion rules to modify dates, you may experience unexpected [&hellip;]<\/p>\n","protected":false},"author":62,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[12345],"tags":[1430],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v19.0 (Yoast SEO v22.1) - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Format Conversion Shows Incorrect Year for Certain Dates in 2020 | Ephesoft Docs<\/title>\n<meta name=\"robots\" content=\"noindex, follow\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Format Conversion Shows Incorrect Year for Certain Dates in 2020\" \/>\n<meta property=\"og:description\" content=\"Applies to: All versions of Ephesoft Transact Issue When creating Format Conversion rules to modify dates, you may experience unexpected [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/ephesoft.com\/docs\/kb00021170-format-conversion\/\" \/>\n<meta property=\"og:site_name\" content=\"Ephesoft Docs\" \/>\n<meta property=\"article:published_time\" content=\"2021-01-29T19:56:41+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2021-12-10T14:15:14+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2021\/01\/word-image-4-1024x412.png\" \/>\n<meta name=\"author\" content=\"Breanna Fitzgerald\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Breanna Fitzgerald\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"1 minute\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/ephesoft.com\/docs\/kb00021170-format-conversion\/\",\"url\":\"https:\/\/ephesoft.com\/docs\/kb00021170-format-conversion\/\",\"name\":\"Format Conversion Shows Incorrect Year for Certain Dates in 2020 | Ephesoft Docs\",\"isPartOf\":{\"@id\":\"https:\/\/ephesoft.com\/docs\/#website\"},\"datePublished\":\"2021-01-29T19:56:41+00:00\",\"dateModified\":\"2021-12-10T14:15:14+00:00\",\"author\":{\"@id\":\"https:\/\/ephesoft.com\/docs\/#\/schema\/person\/d74c698404588430489bf05dfdf4bedd\"},\"breadcrumb\":{\"@id\":\"https:\/\/ephesoft.com\/docs\/kb00021170-format-conversion\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/ephesoft.com\/docs\/kb00021170-format-conversion\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/ephesoft.com\/docs\/kb00021170-format-conversion\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/ephesoft.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Format Conversion Shows Incorrect Year for Certain Dates in 2020\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/ephesoft.com\/docs\/#website\",\"url\":\"https:\/\/ephesoft.com\/docs\/\",\"name\":\"Ephesoft Docs\",\"description\":\"Intelligent Document Processing Made Easy\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/ephesoft.com\/docs\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/ephesoft.com\/docs\/#\/schema\/person\/d74c698404588430489bf05dfdf4bedd\",\"name\":\"Breanna Fitzgerald\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/ephesoft.com\/docs\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/e0624b0af4f5f3caa370053f6eef54c8?s=96&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/e0624b0af4f5f3caa370053f6eef54c8?s=96&r=g\",\"caption\":\"Breanna Fitzgerald\"}}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Format Conversion Shows Incorrect Year for Certain Dates in 2020 | Ephesoft Docs","robots":{"index":"noindex","follow":"follow"},"og_locale":"en_US","og_type":"article","og_title":"Format Conversion Shows Incorrect Year for Certain Dates in 2020","og_description":"Applies to: All versions of Ephesoft Transact Issue When creating Format Conversion rules to modify dates, you may experience unexpected [&hellip;]","og_url":"https:\/\/ephesoft.com\/docs\/kb00021170-format-conversion\/","og_site_name":"Ephesoft Docs","article_published_time":"2021-01-29T19:56:41+00:00","article_modified_time":"2021-12-10T14:15:14+00:00","og_image":[{"url":"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2021\/01\/word-image-4-1024x412.png"}],"author":"Breanna Fitzgerald","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Breanna Fitzgerald","Est. reading time":"1 minute"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/ephesoft.com\/docs\/kb00021170-format-conversion\/","url":"https:\/\/ephesoft.com\/docs\/kb00021170-format-conversion\/","name":"Format Conversion Shows Incorrect Year for Certain Dates in 2020 | Ephesoft Docs","isPartOf":{"@id":"https:\/\/ephesoft.com\/docs\/#website"},"datePublished":"2021-01-29T19:56:41+00:00","dateModified":"2021-12-10T14:15:14+00:00","author":{"@id":"https:\/\/ephesoft.com\/docs\/#\/schema\/person\/d74c698404588430489bf05dfdf4bedd"},"breadcrumb":{"@id":"https:\/\/ephesoft.com\/docs\/kb00021170-format-conversion\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/ephesoft.com\/docs\/kb00021170-format-conversion\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/ephesoft.com\/docs\/kb00021170-format-conversion\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/ephesoft.com\/docs\/"},{"@type":"ListItem","position":2,"name":"Format Conversion Shows Incorrect Year for Certain Dates in 2020"}]},{"@type":"WebSite","@id":"https:\/\/ephesoft.com\/docs\/#website","url":"https:\/\/ephesoft.com\/docs\/","name":"Ephesoft Docs","description":"Intelligent Document Processing Made Easy","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/ephesoft.com\/docs\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/ephesoft.com\/docs\/#\/schema\/person\/d74c698404588430489bf05dfdf4bedd","name":"Breanna Fitzgerald","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/ephesoft.com\/docs\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/e0624b0af4f5f3caa370053f6eef54c8?s=96&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/e0624b0af4f5f3caa370053f6eef54c8?s=96&r=g","caption":"Breanna Fitzgerald"}}]}},"_links":{"self":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/posts\/48059"}],"collection":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/users\/62"}],"replies":[{"embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/comments?post=48059"}],"version-history":[{"count":1,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/posts\/48059\/revisions"}],"predecessor-version":[{"id":50096,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/posts\/48059\/revisions\/50096"}],"wp:attachment":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/media?parent=48059"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/categories?post=48059"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/tags?post=48059"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}