25:["$","title",null,{"children":"Compromise-dates | Yanet's Visualiser | Observable"}] 49:T517,examples=[ // explicit-dates 'march 2nd', '2 march', 'tues march 2', 'march the second', 'on the 2nd', 'tuesday the 2nd', // numeric-dates '2020/03/02', '2020-03-02', '03-02-2020', '03/02', '2020.08.13', // named-dates 'today', 'tomorrow', 'christmas eve', 'easter', 'q1', // times '2pm', '2:12pm', '2:12', '02:12:00', 'two oclock', 'before 1pm', 'noon', 'at night', 'in the morning', 'tomorrow evening', // timezones 'eastern time', 'est', 'peru time', 'GMT+9', '-4h', 'Canada/Eastern', // relative durations 'this march', 'this week', 'this sunday', 'next april', 'this past year', 'second week of march', 'last weekend of march', 'last spring', 'the saturday after next', // punted dates 'in seven weeks', 'two days after june 6th', '2 weeks from now', '2 weeks after june', '2 years, 4 months, and 5 days ago', 'a week and a half before', 'a week friday', // start/end 'end of the week', 'start of next year', 'middle of q2 last year', // date-ranges 'between june and july', 'from today to next haloween', 'aug 1 - aug 31', '22-23 February', 'today to next friday', 'during june', 'aug to june 1999', 'before [2019]', 'by march', 'after february', // repeating-intervals 'any wednesday', 'any day in June', 'any wednesday this week', 'weekends in July', 'every weekday until February', ]4a:[] 29:{"id":"d447fea4448711f1","slug":null,"title":"Compromise-dates","thumbnail":"627858b2d4359b5fc870cc4fe5cdab4e614e953c5e97c2cc607de8445771e69d","access_level":"public","create_time":"$D2023-11-08T08:09:08.604Z","update_time":"$D2023-11-08T19:26:59.938Z","view_time":null,"first_public_time":"$D2023-11-08T08:09:08.604Z","has_unpublished_edits":null,"fork":{"id":"5986801c0a37bb67","slug":"compromise-dates","title":"Compromise-dates","owner":{"id":"178b998367cf1e11","login":"spencermountain","name":"spencer kelly"}},"stars":0,"starred":false,"owner":{"type":"team","id":"2665d0ed6bcc01aa","login":"visualiser","name":"Yanet's Visualiser","avatar_url":"https://avatars-next.observableusercontent.com/9810825ad3127a184e1f4edcb8062952218da8f51b521b015f16a55380cc7930","tier":"starter_2024","bio":"","followed_by_you":false,"follows_you":false},"version":286,"publish_version":null,"role":null,"authored":false,"authors":[{"type":"individual","id":"0c1cb338dcdf0aaa","login":"pippajeanne","name":"Yanet","avatar_url":"https://avatars-next.observableusercontent.com/6b997205c715077bfa57027c82363815c1b39987145a44600429e15a9212498b","tier":null,"bio":"","followed_by_you":false,"follows_you":false}],"members":[{"type":"individual","id":"0c1cb338dcdf0aaa","login":"pippajeanne","name":"Yanet","avatar_url":"https://avatars-next.observableusercontent.com/6b997205c715077bfa57027c82363815c1b39987145a44600429e15a9212498b","tier":null,"role":"editor"},{"type":"team","id":"2665d0ed6bcc01aa","login":"visualiser","name":"Yanet's Visualiser","avatar_url":"https://avatars-next.observableusercontent.com/9810825ad3127a184e1f4edcb8062952218da8f51b521b015f16a55380cc7930","tier":"starter_2024","role":"editor"}],"comments":[],"custom_thumbnail":false,"trashed":false,"lapsed":null,"subscribed":null,"forks":0,"collection":null,"type":"notebook","body":{"titling":"auto","title":"Compromise-dates","cells":[{"id":0,"value":"md`# Compromise-dates\n\n**[compromise](https://observablehq.com/@spencermountain/nlp-compromise)** has the ability to find, parse, and transform natural-language dates, like *'june fifth'* and *'two days after tomorrow'*.\n\nThis is done using the [compromise-dates](https://github.com/spencermountain/compromise/tree/master/plugins/dates) plugin, and \\`compromise/three\\`\n\nTry it out:\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":30,"value":"viewof input = html``","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":42,"value":"{\n let doc = nlp(input)\n // find and interpret each date in the text\n let dates = doc.dates()\n // reformat each one\n //dates.format('{month} {date-ordinal}')\n // return the text\n return dates\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":154,"value":"\nsome supported formats:","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":129,"value":"{\n let results = examples.map(str => {\n let dates = nlp(str).dates()\n if (!dates.found) {\n return [str, '-']\n }\n if(dates.get()[0].start && dates.get()[0].start.match('12:00')){\n return [str, dates.format('{month} {date-ordinal} at {time}').text()]\n }\n return [str, dates.format('{month} {date-ordinal}').text()]\n })\n return html`\n ${results.map(a=> html`\n \n \n `) }\n

${a[0]}

${a[1]}

`\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":107,"value":"\ncompromise-dates uses the [spacetime](http://spacetime.how/) date library for manipulating and formatting dates.\n\n---\n\n### Install\n\n`npm install compromise-dates`\n\nin esmodules:\n```js\nimport nlp from 'compromise'\nimport plg from 'compromise-dates'\nnlp.plugin(plg)\n\nnlp('june fifth').dates().json()\n```\n\n---\n\nor in common-js\n```js\nconst nlp = require('compromise')\nnlp.extend(require('compromise-dates')) //done!\n```\n\n---\n\nor in the browser:\n```html\n\n\n\n```\n","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":16,"value":"md`\n---\n\n## **.dates()**:\ngrab all indivdual and compound date-phrases in the text. Returns an View extended with spcial methods for date-parsing\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":66,"value":"nlp(`we met on June 1st 1992 at 8pm, then got married 1998-03-28.`).dates().out('array')","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":19,"value":"md`### **.json()**:\nget term and date metadata, as output.\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":74,"value":"nlp(`it was two weeks after christmas.`).dates().json()[0]","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":176,"value":"md`### **.get()**:\nhandy method for grabbing individual date isos:\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":179,"value":"nlp(`see you in three days`).dates().get()[0]","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":22,"value":"md`### **.format( str )**:\nconvert the dates to specific formats\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":76,"value":"doc =nlp(`i was born September 5th, 1993. March 4th, 2022`).dates().get()[1].start","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":244,"value":"match= {\n var date = \"\";\n let m;\n const regex = /^\\w*-\\w*-[0-9]*/gm;\nwhile ((m = regex.exec(doc)) !== null) {\n // This is necessary to avoid infinite loops with zero-width matches\n if (m.index === regex.lastIndex) {\n regex.lastIndex++;\n }\n \n // The result can be accessed through the `m`-variable.\n m.forEach((match, groupIndex) => {\n date = match;\n });\n}\n return date\n}","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":182,"value":"md`\n---\n\n## **.durations()**:\nin compromise, durations are phrases like '2 weeks', or 'thirty minutes'. They are similar to dates, but don't refer to a specific ISO, so return a different object:\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":186,"value":"nlp('four days and seven hours passed').durations().get()[0]","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":191,"value":"like dates, we have `.get()` and `.json()` methods:","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":195,"value":"nlp('30mins tuesday').durations().json()[0]","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":198,"value":"md`\n---\n\n## **.times()**:\nin compromise, times are phrases like '14:30', or '3pm eastern'. They are a subset of dates, but don't refer to a specific ISO either.\n\nwe also have \\`.get()\\` and \\`.json()\\` methods:\n`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":202,"value":"nlp('it was 3 in the morning').times().get()[0]","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":204,"value":"nlp('meet at 5pm PST').times().get()[0]","pinned":true,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"$undefined","database":"$undefined"},{"id":206,"value":"\n----\n\n### See also:\n* **[nouns](https://observablehq.com/@spencermountain/nouns)**\n* **[verbs](https://observablehq.com/@spencermountain/verbs)**\n* **[adjectives](https://observablehq.com/@spencermountain/compromise-adjectives)**\n* **[numbers](https://observablehq.com/@spencermountain/compromise-values)**\n","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","tool":"$undefined","providerMetadata":"$undefined","attachments":"$undefined","output":"","database":"$undefined"},{"id":7,"value":"style = html`\n