Startsida Utforska Hjälp
Logga in
levovix
/
Nim
spegling av https://github.com/nim-lang/Nim
Bevaka 1
Stjärnmärk 0
Fork 1
Filer Ärenden 0 Wiki
Träd: d69e064e0c
Grenar Taggar
Nim
/
times.html

times.html 468 KB
Historik Rå

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413 
  1. <?xml version="1.0" encoding="utf-8" ?>
    2. 

  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    3. 

  3. <!--  This file is generated by Nim. -->
    4. 

  4. <html xmlns="https://www.w3.org/1999/xhtml" xml:lang="en" lang="en" data-theme="auto">
    5. 

  5. <head>
    6. 

  6. <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    7. 

  7. <meta name="viewport" content="width=device-width, initial-scale=1.0">
    8. 

  8. <title>std/times</title>
    9. 

  9. 

  10. <!-- Google fonts -->
    11. 

  11. <link href='https://fonts.googleapis.com/css?family=Lato:400,600,900' rel='stylesheet' type='text/css'/>
    12. 

  12. <link href='https://fonts.googleapis.com/css?family=Source+Code+Pro:400,500,600' rel='stylesheet' type='text/css'/>
    13. 

  13. 

  14. <!-- Favicon -->
    15. 

  15. <link rel="shortcut icon" href="data:image/x-icon;base64,AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAUAAAAF////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAIAAABbAAAAlQAAAKIAAACbAAAAmwAAAKIAAACVAAAAWwAAAAL///8A////AP///wD///8A////AAAAABQAAADAAAAAYwAAAA3///8A////AP///wD///8AAAAADQAAAGMAAADAAAAAFP///wD///8A////AP///wAAAACdAAAAOv///wD///8A////AP///wD///8A////AP///wD///8AAAAAOgAAAJ3///8A////AP///wAAAAAnAAAAcP///wAAAAAoAAAASv///wD///8A////AP///wAAAABKAAAAKP///wAAAABwAAAAJ////wD///8AAAAAgQAAABwAAACIAAAAkAAAAJMAAACtAAAAFQAAABUAAACtAAAAkwAAAJAAAACIAAAAHAAAAIH///8A////AAAAAKQAAACrAAAAaP///wD///8AAAAARQAAANIAAADSAAAARf///wD///8AAAAAaAAAAKsAAACk////AAAAADMAAACcAAAAnQAAABj///8A////AP///wAAAAAYAAAAGP///wD///8A////AAAAABgAAACdAAAAnAAAADMAAAB1AAAAwwAAAP8AAADpAAAAsQAAAE4AAAAb////AP///wAAAAAbAAAATgAAALEAAADpAAAA/wAAAMMAAAB1AAAAtwAAAOkAAAD/AAAA/wAAAP8AAADvAAAA3gAAAN4AAADeAAAA3gAAAO8AAAD/AAAA/wAAAP8AAADpAAAAtwAAAGUAAAA/AAAA3wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAADfAAAAPwAAAGX///8A////AAAAAEgAAADtAAAAvwAAAL0AAADGAAAA7wAAAO8AAADGAAAAvQAAAL8AAADtAAAASP///wD///8A////AP///wD///8AAAAAO////wD///8A////AAAAAIcAAACH////AP///wD///8AAAAAO////wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A//8AAP//AAD4HwAA7/cAAN/7AAD//wAAoYUAAJ55AACf+QAAh+EAAAAAAADAAwAA4AcAAP5/AAD//wAA//8AAA=="/>
    16. 

  16. <link rel="icon" type="image/png" sizes="32x32" href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAA3XAAAN1wFCKJt4AAAAB3RJTUUH4QQQEwksSS9ZWwAAAk1JREFUWMPtll2ITVEUx39nn/O7Y5qR8f05wtCUUr6ZIS++8pEnkZInPImneaCQ5METNdOkeFBKUhMPRIkHKfEuUZSUlGlKPN2TrgfncpvmnntnmlEyq1Z7t89/rf9a6+y99oZxGZf/XeIq61EdtgKXgdXA0xrYAvBjOIF1AI9zvjcC74BSpndrJPkBWDScTF8Aa4E3wDlgHbASaANmVqlcCnwHvgDvgVfAJ+AikAAvgfVZwLnSVZHZaOuKoQi3ZOMi4NkYkpe1p4J7A8BpYAD49hfIy/oqG0+hLomiKP2L5L+1ubn5115S+3OAn4EnwBlgMzCjyt6ZAnQCJ4A7wOs88iRJHvw50HoujuPBoCKwHWiosy8MdfZnAdcHk8dxXFJ3VQbQlCTJvRBCGdRbD4M6uc5glpY3eAihpN5S5w12diSEcCCEcKUO4ljdr15T76ur1FDDLIQQ3qv71EdDOe3Kxj3leRXyk+pxdWnFWod6Wt2bY3de3aSuUHcPBVimHs7mK9WrmeOF6lR1o9qnzskh2ar2qm1qizpfXaPeVGdlmGN5pb09qMxz1Xb1kLqgzn1RyH7JUXW52lr5e/Kqi9qpto7V1atuUzfnARrV7jEib1T76gG2qxdGmXyiekkt1GswPTtek0aBfJp6YySGBfWg2tPQ0FAYgf1stUfdmdcjarbYJEniKIq6gY/Aw+zWHAC+p2labGpqiorFYgGYCEzN7oQdQClN07O1/EfDyGgC0ALMBdYAi4FyK+4H3gLPsxfR1zRNi+NP7nH5J+QntnXe5B5mpfQAAAAASUVORK5CYII=">
    17. 

  17. 

  18. <!-- CSS -->
    19. 

  19. <link rel="stylesheet" type="text/css" href="nimdoc.out.css?v=2.3.1">
    20. 

  20. 

  21. <!-- JS -->
    22. 

  22. <script type="text/javascript" src="dochack.js?v=2.3.1"></script>
    23. 

  23. </head>
    24. 

  24. <body>
    25. 

  25.   <div class="document" id="documentId">
    26. 

  26.     <div class="container">
    27. 

  27.       <h1 class="title">std/times</h1>
    28. 

  28.       <div class="row">
    29. 

  29.   <div class="three columns">
    30. 

  30.     <div class="theme-select-wrapper">
    31. 

  31.       <label for="theme-select">Theme:&nbsp;</label>
    32. 

  32.       <select id="theme-select" onchange="setTheme(this.value)">
    33. 

  33.         <option value="auto">🌗 Match OS</option>
    34. 

  34.         <option value="dark">🌑 Dark</option>
    35. 

  35.         <option value="light">🌕 Light</option>
    36. 

  36.       </select>
    37. 

  37.     </div>
    38. 

  38.     <div id="global-links">
    39. 

  39.       <ul class="simple-boot">
    40. 

  40.         <li><a href="manual.html">Manual</a></li>
    41. 

  41.         <li><a href="lib.html">Standard library</a></li>
    42. 

  42.         <li> <a id="indexLink" href="theindex.html">Index</a></li>
    43. 

  43.         <li><a href="compiler/theindex.html">Compiler docs</a></li>
    44. 

  44.         <li><a href="https://nim-lang.github.io/fusion/theindex.html">Fusion docs</a></li>
    45. 

  45.         <li><a href="https://nim-lang.github.io/Nim/">devel</a>, <a href="https://nim-lang.org/documentation.html">stable</a></li>
    46. 

  46.       </ul>
    47. 

  47.     </div>
    48. 

  48.     <div id="searchInputDiv">
    49. 

  49.       Search: <input type="search" id="searchInput"
    50. 

  50.         oninput="search()" />
    51. 

  51.     </div>
    52. 

  52.     
    53. 

  53.     <ul class="simple simple-toc" id="toc-list">
    54. 

  54.   <li><a class="reference" id="examples_toc" href="#examples">Examples</a></li>
    55. 

  55. <li><a class="reference" id="parsing-and-formatting-dates_toc" href="#parsing-and-formatting-dates">Parsing and Formatting Dates</a></li>
    56. 

  56. <li><a class="reference" id="duration-vs-timeinterval_toc" href="#duration-vs-timeinterval">Duration vs TimeInterval</a></li>
    57. 

  57. <ul class="simple"><li><a class="reference" id="duration-vs-timeinterval-duration_toc" href="#duration-vs-timeinterval-duration">Duration</a></li>
    58. 

  58. <li><a class="reference" id="duration-vs-timeinterval-timeinterval_toc" href="#duration-vs-timeinterval-timeinterval">TimeInterval</a></li>
    59. 

  59. <li><a class="reference" id="duration-vs-timeinterval-how-long-is-a-dayqmark_toc" href="#duration-vs-timeinterval-how-long-is-a-dayqmark">How long is a day?</a></li>
    60. 

  60. </ul><li><a class="reference" id="see-also_toc" href="#see-also">See also</a></li>
    61. 

  61. <li>
    62. 

  62.   <a class="reference reference-toplevel" href="#6" id="56">Imports</a>
    63. 

  63. </li>
    64. 

  64. <li>
    65. 

  65.   <details open>
    66. 

  66.     <summary><a class="reference reference-toplevel" href="#7" id="57">Types</a></summary>
    67. 

  67.     <ul class="simple simple-toc-section">
    68. 

  68.       <li><a class="reference" href="#DateTime" title="DateTime = object of RootObj">DateTime</a></li>
    69. 

  69. <li><a class="reference" href="#DateTimeLocale" title="DateTimeLocale = object
    70. 

  70.   MMM*: array[mJan .. mDec, string]
    71. 

  71.   MMMM*: array[mJan .. mDec, string]
    72. 

  72.   ddd*: array[dMon .. dSun, string]
    73. 

  73.   dddd*: array[dMon .. dSun, string]">DateTimeLocale</a></li>
    74. 

  74. <li><a class="reference" href="#Duration" title="Duration = object">Duration</a></li>
    75. 

  75. <li><a class="reference" href="#DurationParts" title="DurationParts = array[FixedTimeUnit, int64]">DurationParts</a></li>
    76. 

  76. <li><a class="reference" href="#FixedTimeUnit" title="FixedTimeUnit = range[Nanoseconds .. Weeks]">FixedTimeUnit</a></li>
    77. 

  77. <li><a class="reference" href="#HourRange" title="HourRange = range[0 .. 23]">HourRange</a></li>
    78. 

  78. <li><a class="reference" href="#IsoWeekRange" title="IsoWeekRange = range[1 .. 53]">IsoWeekRange</a></li>
    79. 

  79. <li><a class="reference" href="#IsoYear" title="IsoYear = distinct int">IsoYear</a></li>
    80. 

  80. <li><a class="reference" href="#MinuteRange" title="MinuteRange = range[0 .. 59]">MinuteRange</a></li>
    81. 

  81. <li><a class="reference" href="#Month" title="Month = enum
    82. 

  82.   mJan = (1, &quot;January&quot;), mFeb = &quot;February&quot;, mMar = &quot;March&quot;, mApr = &quot;April&quot;,
    83. 

  83.   mMay = &quot;May&quot;, mJun = &quot;June&quot;, mJul = &quot;July&quot;, mAug = &quot;August&quot;,
    84. 

  84.   mSep = &quot;September&quot;, mOct = &quot;October&quot;, mNov = &quot;November&quot;, mDec = &quot;December&quot;">Month</a></li>
    85. 

  85. <li><a class="reference" href="#MonthdayRange" title="MonthdayRange = range[1 .. 31]">MonthdayRange</a></li>
    86. 

  86. <li><a class="reference" href="#NanosecondRange" title="NanosecondRange = range[0 .. 999999999]">NanosecondRange</a></li>
    87. 

  87. <li><a class="reference" href="#SecondRange" title="SecondRange = range[0 .. 60]">SecondRange</a></li>
    88. 

  88. <li><a class="reference" href="#Time" title="Time = object">Time</a></li>
    89. 

  89. <li><a class="reference" href="#TimeFormat" title="TimeFormat = object
    90. 

  90.   ## \
    91. 

  91.   ## Contains the patterns encoded as bytes.
    92. 

  92.   ## Literal values are encoded in a special way.
    93. 

  93.   ## They start with `Lit.byte`, then the length of the literal, then the
    94. 

  94.   ## raw char values of the literal. For example, the literal `foo` would
    95. 

  95.   ## be encoded as `@[Lit.byte, 3.byte, 'f'.byte, 'o'.byte, 'o'.byte]`.">TimeFormat</a></li>
    96. 

  96. <li><a class="reference" href="#TimeFormatParseError" title="TimeFormatParseError = object of ValueError">TimeFormatParseError</a></li>
    97. 

  97. <li><a class="reference" href="#TimeInterval" title="TimeInterval = object
    98. 

  98.   nanoseconds*: int          ## The number of nanoseconds
    99. 

  99.   microseconds*: int         ## The number of microseconds
    100. 

  100.   milliseconds*: int         ## The number of milliseconds
    101. 

  101.   seconds*: int              ## The number of seconds
    102. 

  102.   minutes*: int              ## The number of minutes
    103. 

  103.   hours*: int                ## The number of hours
    104. 

  104.   days*: int                 ## The number of days
    105. 

  105.   weeks*: int                ## The number of weeks
    106. 

  106.   months*: int               ## The number of months
    107. 

  107.   years*: int                ## The number of years">TimeInterval</a></li>
    108. 

  108. <li><a class="reference" href="#TimeIntervalParts" title="TimeIntervalParts = array[TimeUnit, int]">TimeIntervalParts</a></li>
    109. 

  109. <li><a class="reference" href="#TimeParseError" title="TimeParseError = object of ValueError">TimeParseError</a></li>
    110. 

  110. <li><a class="reference" href="#TimeUnit" title="TimeUnit = enum
    111. 

  111.   Nanoseconds, Microseconds, Milliseconds, Seconds, Minutes, Hours, Days, Weeks,
    112. 

  112.   Months, Years">TimeUnit</a></li>
    113. 

  113. <li><a class="reference" href="#Timezone" title="Timezone = ref object">Timezone</a></li>
    114. 

  114. <li><a class="reference" href="#WeekDay" title="WeekDay = enum
    115. 

  115.   dMon = &quot;Monday&quot;, dTue = &quot;Tuesday&quot;, dWed = &quot;Wednesday&quot;, dThu = &quot;Thursday&quot;,
    116. 

  116.   dFri = &quot;Friday&quot;, dSat = &quot;Saturday&quot;, dSun = &quot;Sunday&quot;">WeekDay</a></li>
    117. 

  117. <li><a class="reference" href="#YeardayRange" title="YeardayRange = range[0 .. 365]">YeardayRange</a></li>
    118. 

  118. <li><a class="reference" href="#ZonedTime" title="ZonedTime = object
    119. 

  119.   time*: Time                ## The point in time being represented.
    120. 

  120.   utcOffset*: int            ## The offset in seconds west of UTC,
    121. 

  121.                              ## including any offset due to DST.
    122. 

  122.   isDst*: bool               ## Determines whether DST is in effect.">ZonedTime</a></li>
    123. 

  123. 

  124.     </ul>
    125. 

  125.   </details>
    126. 

  126. </li>
    127. 

  127. <li>
    128. 

  128.   <details open>
    129. 

  129.     <summary><a class="reference reference-toplevel" href="#10" id="60">Consts</a></summary>
    130. 

  130.     <ul class="simple simple-toc-section">
    131. 

  131.       <li><a class="reference" href="#DefaultLocale" title="DefaultLocale = (MMM: [&quot;Jan&quot;, &quot;Feb&quot;, &quot;Mar&quot;, &quot;Apr&quot;, &quot;May&quot;, &quot;Jun&quot;, &quot;Jul&quot;, &quot;Aug&quot;,
    132. 

  132.                        &quot;Sep&quot;, &quot;Oct&quot;, &quot;Nov&quot;, &quot;Dec&quot;], MMMM: [&quot;January&quot;,
    133. 

  133.     &quot;February&quot;, &quot;March&quot;, &quot;April&quot;, &quot;May&quot;, &quot;June&quot;, &quot;July&quot;, &quot;August&quot;, &quot;September&quot;,
    134. 

  134.     &quot;October&quot;, &quot;November&quot;, &quot;December&quot;],
    135. 

  135.                  ddd: [&quot;Mon&quot;, &quot;Tue&quot;, &quot;Wed&quot;, &quot;Thu&quot;, &quot;Fri&quot;, &quot;Sat&quot;, &quot;Sun&quot;], dddd: [
    136. 

  136.     &quot;Monday&quot;, &quot;Tuesday&quot;, &quot;Wednesday&quot;, &quot;Thursday&quot;, &quot;Friday&quot;, &quot;Saturday&quot;, &quot;Sunday&quot;])">DefaultLocale</a></li>
    137. 

  137. <li><a class="reference" href="#DurationZero" title="DurationZero = (seconds: 0, nanosecond: 0)">DurationZero</a></li>
    138. 

  138. 

  139.     </ul>
    140. 

  140.   </details>
    141. 

  141. </li>
    142. 

  142. <li>
    143. 

  143.   <details open>
    144. 

  144.     <summary><a class="reference reference-toplevel" href="#12" id="62">Procs</a></summary>
    145. 

  145.     <ul class="simple simple-toc-section">
    146. 

  146.       <ul class="simple nested-toc-section">$
    147. 

  147.   <li><a class="reference" href="#%24%2CDateTime" title="`$`(dt: DateTime): string">`$`(dt: DateTime): string</a></li>
    148. 

  148. <li><a class="reference" href="#%24%2CDuration" title="`$`(dur: Duration): string">`$`(dur: Duration): string</a></li>
    149. 

  149. <li><a class="reference" href="#%24%2CTimeFormat" title="`$`(f: TimeFormat): string">`$`(f: TimeFormat): string</a></li>
    150. 

  150. <li><a class="reference" href="#%24%2CIsoYear" title="`$`(p: IsoYear): string">`$`(p: IsoYear): string</a></li>
    151. 

  151. <li><a class="reference" href="#%24%2CTimeInterval" title="`$`(ti: TimeInterval): string">`$`(ti: TimeInterval): string</a></li>
    152. 

  152. <li><a class="reference" href="#%24%2CTime" title="`$`(time: Time): string">`$`(time: Time): string</a></li>
    153. 

  153. <li><a class="reference" href="#%24%2CTimezone" title="`$`(zone: Timezone): string">`$`(zone: Timezone): string</a></li>
    154. 

  154. 

  155. </ul>
    156. 

  156. <ul class="simple nested-toc-section">*
    157. 

  157.   <li><a class="reference" href="#%2A%2CDuration%2Cint64" title="`*`(a: Duration; b: int64): Duration">`*`(a: Duration; b: int64): Duration</a></li>
    158. 

  158. <li><a class="reference" href="#%2A%2Cint64%2CDuration" title="`*`(a: int64; b: Duration): Duration">`*`(a: int64; b: Duration): Duration</a></li>
    159. 

  159. 

  160. </ul>
    161. 

  161. <ul class="simple nested-toc-section">*=
    162. 

  162.   <li><a class="reference" href="#%2A%3D%2CDuration%2Cint" title="`*=`(a: var Duration; b: int)">`*=`(a: var Duration; b: int)</a></li>
    163. 

  163. 

  164. </ul>
    165. 

  165. <ul class="simple nested-toc-section">+
    166. 

  166.   <li><a class="reference" href="#%2B%2CDuration%2CDuration" title="`+`(a, b: Duration): Duration">`+`(a, b: Duration): Duration</a></li>
    167. 

  167. <li><a class="reference" href="#%2B%2CTime%2CDuration" title="`+`(a: Time; b: Duration): Time">`+`(a: Time; b: Duration): Time</a></li>
    168. 

  168. <li><a class="reference" href="#%2B%2CDateTime%2CDuration" title="`+`(dt: DateTime; dur: Duration): DateTime">`+`(dt: DateTime; dur: Duration): DateTime</a></li>
    169. 

  169. <li><a class="reference" href="#%2B%2CDateTime%2CTimeInterval" title="`+`(dt: DateTime; interval: TimeInterval): DateTime">`+`(dt: DateTime; interval: TimeInterval): DateTime</a></li>
    170. 

  170. <li><a class="reference" href="#%2B%2CTimeInterval%2CTimeInterval" title="`+`(ti1, ti2: TimeInterval): TimeInterval">`+`(ti1, ti2: TimeInterval): TimeInterval</a></li>
    171. 

  171. <li><a class="reference" href="#%2B%2CTime%2CTimeInterval" title="`+`(time: Time; interval: TimeInterval): Time">`+`(time: Time; interval: TimeInterval): Time</a></li>
    172. 

  172. 

  173. </ul>
    174. 

  174. <ul class="simple nested-toc-section">+=
    175. 

  175.   <li><a class="reference" href="#%2B%3D%2CDateTime%2CDuration" title="`+=`(a: var DateTime; b: Duration)">`+=`(a: var DateTime; b: Duration)</a></li>
    176. 

  176. <li><a class="reference" href="#%2B%3D%2CDateTime%2CTimeInterval" title="`+=`(a: var DateTime; b: TimeInterval)">`+=`(a: var DateTime; b: TimeInterval)</a></li>
    177. 

  177. <li><a class="reference" href="#%2B%3D%2CTimeInterval%2CTimeInterval" title="`+=`(a: var TimeInterval; b: TimeInterval)">`+=`(a: var TimeInterval; b: TimeInterval)</a></li>
    178. 

  178. <li><a class="reference" href="#%2B%3D%2CDuration%2CDuration" title="`+=`(d1: var Duration; d2: Duration)">`+=`(d1: var Duration; d2: Duration)</a></li>
    179. 

  179. <li><a class="reference" href="#%2B%3D%2CTime%2CDuration" title="`+=`(t: var Time; b: Duration)">`+=`(t: var Time; b: Duration)</a></li>
    180. 

  180. <li><a class="reference" href="#%2B%3D%2CTime%2CTimeInterval" title="`+=`(t: var Time; b: TimeInterval)">`+=`(t: var Time; b: TimeInterval)</a></li>
    181. 

  181. 

  182. </ul>
    183. 

  183. <ul class="simple nested-toc-section">-
    184. 

  184.   <li><a class="reference" href="#-%2CDuration%2CDuration" title="`-`(a, b: Duration): Duration">`-`(a, b: Duration): Duration</a></li>
    185. 

  185. <li><a class="reference" href="#-%2CTime%2CTime" title="`-`(a, b: Time): Duration">`-`(a, b: Time): Duration</a></li>
    186. 

  186. <li><a class="reference" href="#-%2CDuration" title="`-`(a: Duration): Duration">`-`(a: Duration): Duration</a></li>
    187. 

  187. <li><a class="reference" href="#-%2CTime%2CDuration" title="`-`(a: Time; b: Duration): Time">`-`(a: Time; b: Duration): Time</a></li>
    188. 

  188. <li><a class="reference" href="#-%2CDateTime%2CDateTime" title="`-`(dt1, dt2: DateTime): Duration">`-`(dt1, dt2: DateTime): Duration</a></li>
    189. 

  189. <li><a class="reference" href="#-%2CDateTime%2CDuration" title="`-`(dt: DateTime; dur: Duration): DateTime">`-`(dt: DateTime; dur: Duration): DateTime</a></li>
    190. 

  190. <li><a class="reference" href="#-%2CDateTime%2CTimeInterval" title="`-`(dt: DateTime; interval: TimeInterval): DateTime">`-`(dt: DateTime; interval: TimeInterval): DateTime</a></li>
    191. 

  191. <li><a class="reference" href="#-%2CTimeInterval%2CTimeInterval" title="`-`(ti1, ti2: TimeInterval): TimeInterval">`-`(ti1, ti2: TimeInterval): TimeInterval</a></li>
    192. 

  192. <li><a class="reference" href="#-%2CTimeInterval" title="`-`(ti: TimeInterval): TimeInterval">`-`(ti: TimeInterval): TimeInterval</a></li>
    193. 

  193. <li><a class="reference" href="#-%2CTime%2CTimeInterval" title="`-`(time: Time; interval: TimeInterval): Time">`-`(time: Time; interval: TimeInterval): Time</a></li>
    194. 

  194. 

  195. </ul>
    196. 

  196. <ul class="simple nested-toc-section">-=
    197. 

  197.   <li><a class="reference" href="#-%3D%2CDateTime%2CDuration" title="`-=`(a: var DateTime; b: Duration)">`-=`(a: var DateTime; b: Duration)</a></li>
    198. 

  198. <li><a class="reference" href="#-%3D%2CDateTime%2CTimeInterval" title="`-=`(a: var DateTime; b: TimeInterval)">`-=`(a: var DateTime; b: TimeInterval)</a></li>
    199. 

  199. <li><a class="reference" href="#-%3D%2CTimeInterval%2CTimeInterval" title="`-=`(a: var TimeInterval; b: TimeInterval)">`-=`(a: var TimeInterval; b: TimeInterval)</a></li>
    200. 

  200. <li><a class="reference" href="#-%3D%2CDuration%2CDuration" title="`-=`(dt: var Duration; ti: Duration)">`-=`(dt: var Duration; ti: Duration)</a></li>
    201. 

  201. <li><a class="reference" href="#-%3D%2CTime%2CDuration" title="`-=`(t: var Time; b: Duration)">`-=`(t: var Time; b: Duration)</a></li>
    202. 

  202. <li><a class="reference" href="#-%3D%2CTime%2CTimeInterval" title="`-=`(t: var Time; b: TimeInterval)">`-=`(t: var Time; b: TimeInterval)</a></li>
    203. 

  203. 

  204. </ul>
    205. 

  205. <ul class="simple nested-toc-section"><
    206. 

  206.   <li><a class="reference" href="#%3C%2CDateTime%2CDateTime" title="`&lt;`(a, b: DateTime): bool">`&lt;`(a, b: DateTime): bool</a></li>
    207. 

  207. <li><a class="reference" href="#%3C%2CDuration%2CDuration" title="`&lt;`(a, b: Duration): bool">`&lt;`(a, b: Duration): bool</a></li>
    208. 

  208. <li><a class="reference" href="#%3C%2CTime%2CTime" title="`&lt;`(a, b: Time): bool">`&lt;`(a, b: Time): bool</a></li>
    209. 

  209. 

  210. </ul>
    211. 

  211. <ul class="simple nested-toc-section"><=
    212. 

  212.   <li><a class="reference" href="#%3C%3D%2CDateTime%2CDateTime" title="`&lt;=`(a, b: DateTime): bool">`&lt;=`(a, b: DateTime): bool</a></li>
    213. 

  213. <li><a class="reference" href="#%3C%3D%2CDuration%2CDuration" title="`&lt;=`(a, b: Duration): bool">`&lt;=`(a, b: Duration): bool</a></li>
    214. 

  214. <li><a class="reference" href="#%3C%3D%2CTime%2CTime" title="`&lt;=`(a, b: Time): bool">`&lt;=`(a, b: Time): bool</a></li>
    215. 

  215. 

  216. </ul>
    217. 

  217. <ul class="simple nested-toc-section">==
    218. 

  218.   <li><a class="reference" href="#%3D%3D%2CDateTime%2CDateTime" title="`==`(a, b: DateTime): bool">`==`(a, b: DateTime): bool</a></li>
    219. 

  219. <li><a class="reference" href="#%3D%3D%2CDuration%2CDuration" title="`==`(a, b: Duration): bool">`==`(a, b: Duration): bool</a></li>
    220. 

  220. <li><a class="reference" href="#%3D%3D%2CIsoYear%2CIsoYear" title="`==`(a, b: IsoYear): bool">`==`(a, b: IsoYear): bool</a></li>
    221. 

  221. <li><a class="reference" href="#%3D%3D%2CTime%2CTime" title="`==`(a, b: Time): bool">`==`(a, b: Time): bool</a></li>
    222. 

  222. <li><a class="reference" href="#%3D%3D%2CTimezone%2CTimezone" title="`==`(zone1, zone2: Timezone): bool">`==`(zone1, zone2: Timezone): bool</a></li>
    223. 

  223. 

  224. </ul>
    225. 

  225. <ul class="simple nested-toc-section">abs
    226. 

  226.   <li><a class="reference" href="#abs%2CDuration" title="abs(a: Duration): Duration">abs(a: Duration): Duration</a></li>
    227. 

  227. 

  228. </ul>
    229. 

  229. <ul class="simple nested-toc-section">between
    230. 

  230.   <li><a class="reference" href="#between%2CDateTime%2CDateTime" title="between(startDt, endDt: DateTime): TimeInterval">between(startDt, endDt: DateTime): TimeInterval</a></li>
    231. 

  231. 

  232. </ul>
    233. 

  233. <ul class="simple nested-toc-section">convert
    234. 

  234.   <li><a class="reference" href="#convert%2CFixedTimeUnit%2CFixedTimeUnit%2CT" title="convert[T: SomeInteger](unitFrom, unitTo: FixedTimeUnit; quantity: T): T">convert[T: SomeInteger](unitFrom, unitTo: FixedTimeUnit; quantity: T): T</a></li>
    235. 

  235. 

  236. </ul>
    237. 

  237. <ul class="simple nested-toc-section">cpuTime
    238. 

  238.   <li><a class="reference" href="#cpuTime" title="cpuTime(): float">cpuTime(): float</a></li>
    239. 

  239. 

  240. </ul>
    241. 

  241. <ul class="simple nested-toc-section">dateTime
    242. 

  242.   <li><a class="reference" href="#dateTime%2Cint%2CMonth%2CMonthdayRange%2CHourRange%2CMinuteRange%2CSecondRange%2CNanosecondRange%2CTimezone" title="dateTime(year: int; month: Month; monthday: MonthdayRange; hour: HourRange = 0;
    243. 

  243.          minute: MinuteRange = 0; second: SecondRange = 0;
    244. 

  244.          nanosecond: NanosecondRange = 0; zone: Timezone = local()): DateTime">dateTime(year: int; month: Month; monthday: MonthdayRange; hour: HourRange = 0;
    245. 

  245.          minute: MinuteRange = 0; second: SecondRange = 0;
    246. 

  246.          nanosecond: NanosecondRange = 0; zone: Timezone = local()): DateTime</a></li>
    247. 

  247. 

  248. </ul>
    249. 

  249. <ul class="simple nested-toc-section">days
    250. 

  250.   <li><a class="reference" href="#days%2Cint" title="days(d: int): TimeInterval">days(d: int): TimeInterval</a></li>
    251. 

  251. 

  252. </ul>
    253. 

  253. <ul class="simple nested-toc-section">div
    254. 

  254.   <li><a class="reference" href="#div%2CDuration%2Cint64" title="`div`(a: Duration; b: int64): Duration">`div`(a: Duration; b: int64): Duration</a></li>
    255. 

  255. 

  256. </ul>
    257. 

  257. <ul class="simple nested-toc-section">epochTime
    258. 

  258.   <li><a class="reference" href="#epochTime" title="epochTime(): float">epochTime(): float</a></li>
    259. 

  259. 

  260. </ul>
    261. 

  261. <ul class="simple nested-toc-section">format
    262. 

  262.   <li><a class="reference" href="#format%2CDateTime%2Cstatic%5Bstring%5D" title="format(dt: DateTime; f: static[string]): string">format(dt: DateTime; f: static[string]): string</a></li>
    263. 

  263. <li><a class="reference" href="#format%2CDateTime%2Cstring%2CDateTimeLocale" title="format(dt: DateTime; f: string; loc: DateTimeLocale = DefaultLocale): string">format(dt: DateTime; f: string; loc: DateTimeLocale = DefaultLocale): string</a></li>
    264. 

  264. <li><a class="reference" href="#format%2CDateTime%2CTimeFormat%2CDateTimeLocale" title="format(dt: DateTime; f: TimeFormat; loc: DateTimeLocale = DefaultLocale): string">format(dt: DateTime; f: TimeFormat; loc: DateTimeLocale = DefaultLocale): string</a></li>
    265. 

  265. <li><a class="reference" href="#format%2CTime%2Cstatic%5Bstring%5D%2CTimezone" title="format(time: Time; f: static[string]; zone: Timezone = local()): string">format(time: Time; f: static[string]; zone: Timezone = local()): string</a></li>
    266. 

  266. <li><a class="reference" href="#format%2CTime%2Cstring%2CTimezone" title="format(time: Time; f: string; zone: Timezone = local()): string">format(time: Time; f: string; zone: Timezone = local()): string</a></li>
    267. 

  267. 

  268. </ul>
    269. 

  269. <ul class="simple nested-toc-section">formatValue
    270. 

  270.   <li><a class="reference" href="#formatValue%2Cstring%2C%2Cstring" title="formatValue(result: var string; value: DateTime | Time; specifier: string)">formatValue(result: var string; value: DateTime | Time; specifier: string)</a></li>
    271. 

  271. 

  272. </ul>
    273. 

  273. <ul class="simple nested-toc-section">fromUnix
    274. 

  274.   <li><a class="reference" href="#fromUnix%2Cint64" title="fromUnix(unix: int64): Time">fromUnix(unix: int64): Time</a></li>
    275. 

  275. 

  276. </ul>
    277. 

  277. <ul class="simple nested-toc-section">fromUnixFloat
    278. 

  278.   <li><a class="reference" href="#fromUnixFloat%2Cfloat" title="fromUnixFloat(seconds: float): Time">fromUnixFloat(seconds: float): Time</a></li>
    279. 

  279. 

  280. </ul>
    281. 

  281. <ul class="simple nested-toc-section">fromWinTime
    282. 

  282.   <li><a class="reference" href="#fromWinTime%2Cint64" title="fromWinTime(win: int64): Time">fromWinTime(win: int64): Time</a></li>
    283. 

  283. 

  284. </ul>
    285. 

  285. <ul class="simple nested-toc-section">getClockStr
    286. 

  286.   <li><a class="reference" href="#getClockStr" title="getClockStr(dt = now()): string">getClockStr(dt = now()): string</a></li>
    287. 

  287. 

  288. </ul>
    289. 

  289. <ul class="simple nested-toc-section">getDateStr
    290. 

  290.   <li><a class="reference" href="#getDateStr" title="getDateStr(dt = now()): string">getDateStr(dt = now()): string</a></li>
    291. 

  291. 

  292. </ul>
    293. 

  293. <ul class="simple nested-toc-section">getDayOfWeek
    294. 

  294.   <li><a class="reference" href="#getDayOfWeek%2CMonthdayRange%2CMonth%2Cint" title="getDayOfWeek(monthday: MonthdayRange; month: Month; year: int): WeekDay">getDayOfWeek(monthday: MonthdayRange; month: Month; year: int): WeekDay</a></li>
    295. 

  295. 

  296. </ul>
    297. 

  297. <ul class="simple nested-toc-section">getDayOfYear
    298. 

  298.   <li><a class="reference" href="#getDayOfYear%2CMonthdayRange%2CMonth%2Cint" title="getDayOfYear(monthday: MonthdayRange; month: Month; year: int): YeardayRange">getDayOfYear(monthday: MonthdayRange; month: Month; year: int): YeardayRange</a></li>
    299. 

  299. 

  300. </ul>
    301. 

  301. <ul class="simple nested-toc-section">getDaysInMonth
    302. 

  302.   <li><a class="reference" href="#getDaysInMonth%2CMonth%2Cint" title="getDaysInMonth(month: Month; year: int): int">getDaysInMonth(month: Month; year: int): int</a></li>
    303. 

  303. 

  304. </ul>
    305. 

  305. <ul class="simple nested-toc-section">getDaysInYear
    306. 

  306.   <li><a class="reference" href="#getDaysInYear%2Cint" title="getDaysInYear(year: int): int">getDaysInYear(year: int): int</a></li>
    307. 

  307. 

  308. </ul>
    309. 

  309. <ul class="simple nested-toc-section">getIsoWeekAndYear
    310. 

  310.   <li><a class="reference" href="#getIsoWeekAndYear%2CDateTime" title="getIsoWeekAndYear(dt: DateTime): tuple[isoweek: IsoWeekRange, isoyear: IsoYear]">getIsoWeekAndYear(dt: DateTime): tuple[isoweek: IsoWeekRange, isoyear: IsoYear]</a></li>
    311. 

  311. 

  312. </ul>
    313. 

  313. <ul class="simple nested-toc-section">getTime
    314. 

  314.   <li><a class="reference" href="#getTime" title="getTime(): Time">getTime(): Time</a></li>
    315. 

  315. 

  316. </ul>
    317. 

  317. <ul class="simple nested-toc-section">getWeeksInIsoYear
    318. 

  318.   <li><a class="reference" href="#getWeeksInIsoYear%2CIsoYear" title="getWeeksInIsoYear(y: IsoYear): IsoWeekRange">getWeeksInIsoYear(y: IsoYear): IsoWeekRange</a></li>
    319. 

  319. 

  320. </ul>
    321. 

  321. <ul class="simple nested-toc-section">high
    322. 

  322.   <li><a class="reference" href="#high%2Ctypedesc%5BDuration%5D" title="high(typ: typedesc[Duration]): Duration">high(typ: typedesc[Duration]): Duration</a></li>
    323. 

  323. <li><a class="reference" href="#high%2Ctypedesc%5BTime%5D" title="high(typ: typedesc[Time]): Time">high(typ: typedesc[Time]): Time</a></li>
    324. 

  324. 

  325. </ul>
    326. 

  326. <ul class="simple nested-toc-section">hour
    327. 

  327.   <li><a class="reference" href="#hour%2CDateTime" title="hour(dt: DateTime): HourRange">hour(dt: DateTime): HourRange</a></li>
    328. 

  328. 

  329. </ul>
    330. 

  330. <ul class="simple nested-toc-section">hour=
    331. 

  331.   <li><a class="reference" href="#hour%3D%2CDateTime%2CHourRange" title="hour=(dt: var DateTime; value: HourRange)">hour=(dt: var DateTime; value: HourRange)</a></li>
    332. 

  332. 

  333. </ul>
    334. 

  334. <ul class="simple nested-toc-section">hours
    335. 

  335.   <li><a class="reference" href="#hours%2Cint" title="hours(h: int): TimeInterval">hours(h: int): TimeInterval</a></li>
    336. 

  336. 

  337. </ul>
    338. 

  338. <ul class="simple nested-toc-section">inDays
    339. 

  339.   <li><a class="reference" href="#inDays%2CDuration" title="inDays(dur: Duration): int64">inDays(dur: Duration): int64</a></li>
    340. 

  340. 

  341. </ul>
    342. 

  342. <ul class="simple nested-toc-section">inHours
    343. 

  343.   <li><a class="reference" href="#inHours%2CDuration" title="inHours(dur: Duration): int64">inHours(dur: Duration): int64</a></li>
    344. 

  344. 

  345. </ul>
    346. 

  346. <ul class="simple nested-toc-section">initDateTime
    347. 

  347.   <li><a class="reference" href="#initDateTime%2CMonthdayRange%2CMonth%2Cint%2CHourRange%2CMinuteRange%2CSecondRange%2CNanosecondRange%2CTimezone" title="initDateTime(monthday: MonthdayRange; month: Month; year: int; hour: HourRange;
    348. 

  348.              minute: MinuteRange; second: SecondRange;
    349. 

  349.              nanosecond: NanosecondRange; zone: Timezone = local()): DateTime">initDateTime(monthday: MonthdayRange; month: Month; year: int; hour: HourRange;
    350. 

  350.              minute: MinuteRange; second: SecondRange;
    351. 

  351.              nanosecond: NanosecondRange; zone: Timezone = local()): DateTime</a></li>
    352. 

  352. <li><a class="reference" href="#initDateTime%2CMonthdayRange%2CMonth%2Cint%2CHourRange%2CMinuteRange%2CSecondRange%2CTimezone" title="initDateTime(monthday: MonthdayRange; month: Month; year: int; hour: HourRange;
    353. 

  353.              minute: MinuteRange; second: SecondRange; zone: Timezone = local()): DateTime">initDateTime(monthday: MonthdayRange; month: Month; year: int; hour: HourRange;
    354. 

  354.              minute: MinuteRange; second: SecondRange; zone: Timezone = local()): DateTime</a></li>
    355. 

  355. <li><a class="reference" href="#initDateTime%2CWeekDay%2CIsoWeekRange%2CIsoYear%2CHourRange%2CMinuteRange%2CSecondRange%2CNanosecondRange%2CTimezone" title="initDateTime(weekday: WeekDay; isoweek: IsoWeekRange; isoyear: IsoYear;
    356. 

  356.              hour: HourRange; minute: MinuteRange; second: SecondRange;
    357. 

  357.              nanosecond: NanosecondRange; zone: Timezone = local()): DateTime">initDateTime(weekday: WeekDay; isoweek: IsoWeekRange; isoyear: IsoYear;
    358. 

  358.              hour: HourRange; minute: MinuteRange; second: SecondRange;
    359. 

  359.              nanosecond: NanosecondRange; zone: Timezone = local()): DateTime</a></li>
    360. 

  360. <li><a class="reference" href="#initDateTime%2CWeekDay%2CIsoWeekRange%2CIsoYear%2CHourRange%2CMinuteRange%2CSecondRange%2CTimezone" title="initDateTime(weekday: WeekDay; isoweek: IsoWeekRange; isoyear: IsoYear;
    361. 

  361.              hour: HourRange; minute: MinuteRange; second: SecondRange;
    362. 

  362.              zone: Timezone = local()): DateTime">initDateTime(weekday: WeekDay; isoweek: IsoWeekRange; isoyear: IsoYear;
    363. 

  363.              hour: HourRange; minute: MinuteRange; second: SecondRange;
    364. 

  364.              zone: Timezone = local()): DateTime</a></li>
    365. 

  365. 

  366. </ul>
    367. 

  367. <ul class="simple nested-toc-section">initDuration
    368. 

  368.   <li><a class="reference" href="#initDuration%2Cint64%2Cint64%2Cint64%2Cint64%2Cint64%2Cint64%2Cint64%2Cint64" title="initDuration(nanoseconds, microseconds, milliseconds, seconds, minutes, hours,
    369. 

  369.              days, weeks: int64 = 0): Duration">initDuration(nanoseconds, microseconds, milliseconds, seconds, minutes, hours,
    370. 

  370.              days, weeks: int64 = 0): Duration</a></li>
    371. 

  371. 

  372. </ul>
    373. 

  373. <ul class="simple nested-toc-section">initTime
    374. 

  374.   <li><a class="reference" href="#initTime%2Cint64%2CNanosecondRange" title="initTime(unix: int64; nanosecond: NanosecondRange): Time">initTime(unix: int64; nanosecond: NanosecondRange): Time</a></li>
    375. 

  375. 

  376. </ul>
    377. 

  377. <ul class="simple nested-toc-section">initTimeFormat
    378. 

  378.   <li><a class="reference" href="#initTimeFormat%2Cstring" title="initTimeFormat(format: string): TimeFormat">initTimeFormat(format: string): TimeFormat</a></li>
    379. 

  379. 

  380. </ul>
    381. 

  381. <ul class="simple nested-toc-section">initTimeInterval
    382. 

  382.   <li><a class="reference" href="#initTimeInterval%2Cint%2Cint%2Cint%2Cint%2Cint%2Cint%2Cint%2Cint%2Cint%2Cint" title="initTimeInterval(nanoseconds = 0; microseconds = 0; milliseconds = 0;
    383. 

  383.                  seconds = 0; minutes = 0; hours = 0; days = 0; weeks = 0;
    384. 

  384.                  months = 0; years = 0): TimeInterval">initTimeInterval(nanoseconds = 0; microseconds = 0; milliseconds = 0;
    385. 

  385.                  seconds = 0; minutes = 0; hours = 0; days = 0; weeks = 0;
    386. 

  386.                  months = 0; years = 0): TimeInterval</a></li>
    387. 

  387. 

  388. </ul>
    389. 

  389. <ul class="simple nested-toc-section">inMicroseconds
    390. 

  390.   <li><a class="reference" href="#inMicroseconds%2CDuration" title="inMicroseconds(dur: Duration): int64">inMicroseconds(dur: Duration): int64</a></li>
    391. 

  391. 

  392. </ul>
    393. 

  393. <ul class="simple nested-toc-section">inMilliseconds
    394. 

  394.   <li><a class="reference" href="#inMilliseconds%2CDuration" title="inMilliseconds(dur: Duration): int64">inMilliseconds(dur: Duration): int64</a></li>
    395. 

  395. 

  396. </ul>
    397. 

  397. <ul class="simple nested-toc-section">inMinutes
    398. 

  398.   <li><a class="reference" href="#inMinutes%2CDuration" title="inMinutes(dur: Duration): int64">inMinutes(dur: Duration): int64</a></li>
    399. 

  399. 

  400. </ul>
    401. 

  401. <ul class="simple nested-toc-section">inNanoseconds
    402. 

  402.   <li><a class="reference" href="#inNanoseconds%2CDuration" title="inNanoseconds(dur: Duration): int64">inNanoseconds(dur: Duration): int64</a></li>
    403. 

  403. 

  404. </ul>
    405. 

  405. <ul class="simple nested-toc-section">inSeconds
    406. 

  406.   <li><a class="reference" href="#inSeconds%2CDuration" title="inSeconds(dur: Duration): int64">inSeconds(dur: Duration): int64</a></li>
    407. 

  407. 

  408. </ul>
    409. 

  409. <ul class="simple nested-toc-section">inWeeks
    410. 

  410.   <li><a class="reference" href="#inWeeks%2CDuration" title="inWeeks(dur: Duration): int64">inWeeks(dur: Duration): int64</a></li>
    411. 

  411. 

  412. </ul>
    413. 

  413. <ul class="simple nested-toc-section">inZone
    414. 

  414.   <li><a class="reference" href="#inZone%2CDateTime%2CTimezone" title="inZone(dt: DateTime; zone: Timezone): DateTime">inZone(dt: DateTime; zone: Timezone): DateTime</a></li>
    415. 

  415. <li><a class="reference" href="#inZone%2CTime%2CTimezone" title="inZone(time: Time; zone: Timezone): DateTime">inZone(time: Time; zone: Timezone): DateTime</a></li>
    416. 

  416. 

  417. </ul>
    418. 

  418. <ul class="simple nested-toc-section">isDst
    419. 

  419.   <li><a class="reference" href="#isDst%2CDateTime" title="isDst(dt: DateTime): bool">isDst(dt: DateTime): bool</a></li>
    420. 

  420. 

  421. </ul>
    422. 

  422. <ul class="simple nested-toc-section">isDst=
    423. 

  423.   <li><a class="reference" href="#isDst%3D%2CDateTime%2Cbool" title="isDst=(dt: var DateTime; value: bool)">isDst=(dt: var DateTime; value: bool)</a></li>
    424. 

  424. 

  425. </ul>
    426. 

  426. <ul class="simple nested-toc-section">isInitialized
    427. 

  427.   <li><a class="reference" href="#isInitialized%2CDateTime" title="isInitialized(dt: DateTime): bool">isInitialized(dt: DateTime): bool</a></li>
    428. 

  428. 

  429. </ul>
    430. 

  430. <ul class="simple nested-toc-section">isLeapDay
    431. 

  431.   <li><a class="reference" href="#isLeapDay%2CDateTime" title="isLeapDay(dt: DateTime): bool">isLeapDay(dt: DateTime): bool</a></li>
    432. 

  432. 

  433. </ul>
    434. 

  434. <ul class="simple nested-toc-section">isLeapYear
    435. 

  435.   <li><a class="reference" href="#isLeapYear%2Cint" title="isLeapYear(year: int): bool">isLeapYear(year: int): bool</a></li>
    436. 

  436. 

  437. </ul>
    438. 

  438. <ul class="simple nested-toc-section">local
    439. 

  439.   <li><a class="reference" href="#local" title="local(): Timezone">local(): Timezone</a></li>
    440. 

  440. <li><a class="reference" href="#local%2CDateTime" title="local(dt: DateTime): DateTime">local(dt: DateTime): DateTime</a></li>
    441. 

  441. <li><a class="reference" href="#local%2CTime" title="local(t: Time): DateTime">local(t: Time): DateTime</a></li>
    442. 

  442. 

  443. </ul>
    444. 

  444. <ul class="simple nested-toc-section">low
    445. 

  445.   <li><a class="reference" href="#low%2Ctypedesc%5BDuration%5D" title="low(typ: typedesc[Duration]): Duration">low(typ: typedesc[Duration]): Duration</a></li>
    446. 

  446. <li><a class="reference" href="#low%2Ctypedesc%5BTime%5D" title="low(typ: typedesc[Time]): Time">low(typ: typedesc[Time]): Time</a></li>
    447. 

  447. 

  448. </ul>
    449. 

  449. <ul class="simple nested-toc-section">microseconds
    450. 

  450.   <li><a class="reference" href="#microseconds%2Cint" title="microseconds(micros: int): TimeInterval">microseconds(micros: int): TimeInterval</a></li>
    451. 

  451. 

  452. </ul>
    453. 

  453. <ul class="simple nested-toc-section">milliseconds
    454. 

  454.   <li><a class="reference" href="#milliseconds%2Cint" title="milliseconds(ms: int): TimeInterval">milliseconds(ms: int): TimeInterval</a></li>
    455. 

  455. 

  456. </ul>
    457. 

  457. <ul class="simple nested-toc-section">minute
    458. 

  458.   <li><a class="reference" href="#minute%2CDateTime" title="minute(dt: DateTime): MinuteRange">minute(dt: DateTime): MinuteRange</a></li>
    459. 

  459. 

  460. </ul>
    461. 

  461. <ul class="simple nested-toc-section">minute=
    462. 

  462.   <li><a class="reference" href="#minute%3D%2CDateTime%2CMinuteRange" title="minute=(dt: var DateTime; value: MinuteRange)">minute=(dt: var DateTime; value: MinuteRange)</a></li>
    463. 

  463. 

  464. </ul>
    465. 

  465. <ul class="simple nested-toc-section">minutes
    466. 

  466.   <li><a class="reference" href="#minutes%2Cint" title="minutes(m: int): TimeInterval">minutes(m: int): TimeInterval</a></li>
    467. 

  467. 

  468. </ul>
    469. 

  469. <ul class="simple nested-toc-section">month
    470. 

  470.   <li><a class="reference" href="#month%2CDateTime" title="month(dt: DateTime): Month">month(dt: DateTime): Month</a></li>
    471. 

  471. 

  472. </ul>
    473. 

  473. <ul class="simple nested-toc-section">monthday
    474. 

  474.   <li><a class="reference" href="#monthday%2CDateTime" title="monthday(dt: DateTime): MonthdayRange">monthday(dt: DateTime): MonthdayRange</a></li>
    475. 

  475. 

  476. </ul>
    477. 

  477. <ul class="simple nested-toc-section">monthdayZero=
    478. 

  478.   <li><a class="reference" href="#monthdayZero%3D%2CDateTime%2Cint" title="monthdayZero=(dt: var DateTime; value: int)">monthdayZero=(dt: var DateTime; value: int)</a></li>
    479. 

  479. 

  480. </ul>
    481. 

  481. <ul class="simple nested-toc-section">months
    482. 

  482.   <li><a class="reference" href="#months%2Cint" title="months(m: int): TimeInterval">months(m: int): TimeInterval</a></li>
    483. 

  483. 

  484. </ul>
    485. 

  485. <ul class="simple nested-toc-section">monthZero=
    486. 

  486.   <li><a class="reference" href="#monthZero%3D%2CDateTime%2Cint" title="monthZero=(dt: var DateTime; value: int)">monthZero=(dt: var DateTime; value: int)</a></li>
    487. 

  487. 

  488. </ul>
    489. 

  489. <ul class="simple nested-toc-section">name
    490. 

  490.   <li><a class="reference" href="#name%2CTimezone" title="name(zone: Timezone): string">name(zone: Timezone): string</a></li>
    491. 

  491. 

  492. </ul>
    493. 

  493. <ul class="simple nested-toc-section">nanosecond
    494. 

  494.   <li><a class="reference" href="#nanosecond%2CDateTime" title="nanosecond(dt: DateTime): NanosecondRange">nanosecond(dt: DateTime): NanosecondRange</a></li>
    495. 

  495. <li><a class="reference" href="#nanosecond%2CTime" title="nanosecond(time: Time): NanosecondRange">nanosecond(time: Time): NanosecondRange</a></li>
    496. 

  496. 

  497. </ul>
    498. 

  498. <ul class="simple nested-toc-section">nanosecond=
    499. 

  499.   <li><a class="reference" href="#nanosecond%3D%2CDateTime%2CNanosecondRange" title="nanosecond=(dt: var DateTime; value: NanosecondRange)">nanosecond=(dt: var DateTime; value: NanosecondRange)</a></li>
    500. 

  500. 

  501. </ul>
    502. 

  502. <ul class="simple nested-toc-section">nanoseconds
    503. 

  503.   <li><a class="reference" href="#nanoseconds%2Cint" title="nanoseconds(nanos: int): TimeInterval">nanoseconds(nanos: int): TimeInterval</a></li>
    504. 

  504. 

  505. </ul>
    506. 

  506. <ul class="simple nested-toc-section">newTimezone
    507. 

  507.   <li><a class="reference" href="#newTimezone%2Cstring%2Cproc%28Time%29%2Cproc%28Time%29" title="newTimezone(name: string; zonedTimeFromTimeImpl: proc (time: Time): ZonedTime {.
    508. 

  508.     tags: [], raises: [], gcsafe.}; zonedTimeFromAdjTimeImpl: proc (
    509. 

  509.     adjTime: Time): ZonedTime {.tags: [], raises: [], gcsafe.}): owned Timezone">newTimezone(name: string; zonedTimeFromTimeImpl: proc (time: Time): ZonedTime {.
    510. 

  510.     tags: [], raises: [], gcsafe.}; zonedTimeFromAdjTimeImpl: proc (
    511. 

  511.     adjTime: Time): ZonedTime {.tags: [], raises: [], gcsafe.}): owned Timezone</a></li>
    512. 

  512. 

  513. </ul>
    514. 

  514. <ul class="simple nested-toc-section">now
    515. 

  515.   <li><a class="reference" href="#now" title="now(): DateTime">now(): DateTime</a></li>
    516. 

  516. 

  517. </ul>
    518. 

  518. <ul class="simple nested-toc-section">parse
    519. 

  519.   <li><a class="reference" href="#parse%2Cstring%2Cstring%2CTimezone%2CDateTimeLocale" title="parse(input, f: string; tz: Timezone = local();
    520. 

  520.       loc: DateTimeLocale = DefaultLocale): DateTime">parse(input, f: string; tz: Timezone = local();
    521. 

  521.       loc: DateTimeLocale = DefaultLocale): DateTime</a></li>
    522. 

  522. <li><a class="reference" href="#parse%2Cstring%2Cstatic%5Bstring%5D%2CTimezone%2CDateTimeLocale" title="parse(input: string; f: static[string]; zone: Timezone = local();
    523. 

  523.       loc: DateTimeLocale = DefaultLocale): DateTime">parse(input: string; f: static[string]; zone: Timezone = local();
    524. 

  524.       loc: DateTimeLocale = DefaultLocale): DateTime</a></li>
    525. 

  525. <li><a class="reference" href="#parse%2Cstring%2CTimeFormat%2CTimezone%2CDateTimeLocale" title="parse(input: string; f: TimeFormat; zone: Timezone = local();
    526. 

  526.       loc: DateTimeLocale = DefaultLocale): DateTime">parse(input: string; f: TimeFormat; zone: Timezone = local();
    527. 

  527.       loc: DateTimeLocale = DefaultLocale): DateTime</a></li>
    528. 

  528. 

  529. </ul>
    530. 

  530. <ul class="simple nested-toc-section">parseTime
    531. 

  531.   <li><a class="reference" href="#parseTime%2Cstring%2Cstring%2CTimezone" title="parseTime(input, f: string; zone: Timezone): Time">parseTime(input, f: string; zone: Timezone): Time</a></li>
    532. 

  532. <li><a class="reference" href="#parseTime%2Cstring%2Cstatic%5Bstring%5D%2CTimezone" title="parseTime(input: string; f: static[string]; zone: Timezone): Time">parseTime(input: string; f: static[string]; zone: Timezone): Time</a></li>
    533. 

  533. 

  534. </ul>
    535. 

  535. <ul class="simple nested-toc-section">second
    536. 

  536.   <li><a class="reference" href="#second%2CDateTime" title="second(dt: DateTime): SecondRange">second(dt: DateTime): SecondRange</a></li>
    537. 

  537. 

  538. </ul>
    539. 

  539. <ul class="simple nested-toc-section">second=
    540. 

  540.   <li><a class="reference" href="#second%3D%2CDateTime%2CSecondRange" title="second=(dt: var DateTime; value: SecondRange)">second=(dt: var DateTime; value: SecondRange)</a></li>
    541. 

  541. 

  542. </ul>
    543. 

  543. <ul class="simple nested-toc-section">seconds
    544. 

  544.   <li><a class="reference" href="#seconds%2Cint" title="seconds(s: int): TimeInterval">seconds(s: int): TimeInterval</a></li>
    545. 

  545. 

  546. </ul>
    547. 

  547. <ul class="simple nested-toc-section">timezone
    548. 

  548.   <li><a class="reference" href="#timezone%2CDateTime" title="timezone(dt: DateTime): Timezone">timezone(dt: DateTime): Timezone</a></li>
    549. 

  549. 

  550. </ul>
    551. 

  551. <ul class="simple nested-toc-section">timezone=
    552. 

  552.   <li><a class="reference" href="#timezone%3D%2CDateTime%2CTimezone" title="timezone=(dt: var DateTime; value: Timezone)">timezone=(dt: var DateTime; value: Timezone)</a></li>
    553. 

  553. 

  554. </ul>
    555. 

  555. <ul class="simple nested-toc-section">toParts
    556. 

  556.   <li><a class="reference" href="#toParts%2CDuration" title="toParts(dur: Duration): DurationParts">toParts(dur: Duration): DurationParts</a></li>
    557. 

  557. <li><a class="reference" href="#toParts%2CTimeInterval" title="toParts(ti: TimeInterval): TimeIntervalParts">toParts(ti: TimeInterval): TimeIntervalParts</a></li>
    558. 

  558. 

  559. </ul>
    560. 

  560. <ul class="simple nested-toc-section">toTime
    561. 

  561.   <li><a class="reference" href="#toTime%2CDateTime" title="toTime(dt: DateTime): Time">toTime(dt: DateTime): Time</a></li>
    562. 

  562. 

  563. </ul>
    564. 

  564. <ul class="simple nested-toc-section">toUnix
    565. 

  565.   <li><a class="reference" href="#toUnix%2CTime" title="toUnix(t: Time): int64">toUnix(t: Time): int64</a></li>
    566. 

  566. 

  567. </ul>
    568. 

  568. <ul class="simple nested-toc-section">toUnixFloat
    569. 

  569.   <li><a class="reference" href="#toUnixFloat%2CTime" title="toUnixFloat(t: Time): float">toUnixFloat(t: Time): float</a></li>
    570. 

  570. 

  571. </ul>
    572. 

  572. <ul class="simple nested-toc-section">toWinTime
    573. 

  573.   <li><a class="reference" href="#toWinTime%2CTime" title="toWinTime(t: Time): int64">toWinTime(t: Time): int64</a></li>
    574. 

  574. 

  575. </ul>
    576. 

  576. <ul class="simple nested-toc-section">utc
    577. 

  577.   <li><a class="reference" href="#utc" title="utc(): Timezone">utc(): Timezone</a></li>
    578. 

  578. <li><a class="reference" href="#utc%2CDateTime" title="utc(dt: DateTime): DateTime">utc(dt: DateTime): DateTime</a></li>
    579. 

  579. <li><a class="reference" href="#utc%2CTime" title="utc(t: Time): DateTime">utc(t: Time): DateTime</a></li>
    580. 

  580. 

  581. </ul>
    582. 

  582. <ul class="simple nested-toc-section">utcOffset
    583. 

  583.   <li><a class="reference" href="#utcOffset%2CDateTime" title="utcOffset(dt: DateTime): int">utcOffset(dt: DateTime): int</a></li>
    584. 

  584. 

  585. </ul>
    586. 

  586. <ul class="simple nested-toc-section">utcOffset=
    587. 

  587.   <li><a class="reference" href="#utcOffset%3D%2CDateTime%2Cint" title="utcOffset=(dt: var DateTime; value: int)">utcOffset=(dt: var DateTime; value: int)</a></li>
    588. 

  588. 

  589. </ul>
    590. 

  590. <ul class="simple nested-toc-section">weekday
    591. 

  591.   <li><a class="reference" href="#weekday%2CDateTime" title="weekday(dt: DateTime): WeekDay">weekday(dt: DateTime): WeekDay</a></li>
    592. 

  592. 

  593. </ul>
    594. 

  594. <ul class="simple nested-toc-section">weekday=
    595. 

  595.   <li><a class="reference" href="#weekday%3D%2CDateTime%2CWeekDay" title="weekday=(dt: var DateTime; value: WeekDay)">weekday=(dt: var DateTime; value: WeekDay)</a></li>
    596. 

  596. 

  597. </ul>
    598. 

  598. <ul class="simple nested-toc-section">weeks
    599. 

  599.   <li><a class="reference" href="#weeks%2Cint" title="weeks(w: int): TimeInterval">weeks(w: int): TimeInterval</a></li>
    600. 

  600. 

  601. </ul>
    602. 

  602. <ul class="simple nested-toc-section">year
    603. 

  603.   <li><a class="reference" href="#year%2CDateTime" title="year(dt: DateTime): int">year(dt: DateTime): int</a></li>
    604. 

  604. 

  605. </ul>
    606. 

  606. <ul class="simple nested-toc-section">year=
    607. 

  607.   <li><a class="reference" href="#year%3D%2CDateTime%2Cint" title="year=(dt: var DateTime; value: int)">year=(dt: var DateTime; value: int)</a></li>
    608. 

  608. 

  609. </ul>
    610. 

  610. <ul class="simple nested-toc-section">yearday
    611. 

  611.   <li><a class="reference" href="#yearday%2CDateTime" title="yearday(dt: DateTime): YeardayRange">yearday(dt: DateTime): YeardayRange</a></li>
    612. 

  612. 

  613. </ul>
    614. 

  614. <ul class="simple nested-toc-section">yearday=
    615. 

  615.   <li><a class="reference" href="#yearday%3D%2CDateTime%2CYeardayRange" title="yearday=(dt: var DateTime; value: YeardayRange)">yearday=(dt: var DateTime; value: YeardayRange)</a></li>
    616. 

  616. 

  617. </ul>
    618. 

  618. <ul class="simple nested-toc-section">years
    619. 

  619.   <li><a class="reference" href="#years%2Cint" title="years(y: int): TimeInterval">years(y: int): TimeInterval</a></li>
    620. 

  620. 

  621. </ul>
    622. 

  622. <ul class="simple nested-toc-section">zonedTimeFromAdjTime
    623. 

  623.   <li><a class="reference" href="#zonedTimeFromAdjTime%2CTimezone%2CTime" title="zonedTimeFromAdjTime(zone: Timezone; adjTime: Time): ZonedTime">zonedTimeFromAdjTime(zone: Timezone; adjTime: Time): ZonedTime</a></li>
    624. 

  624. 

  625. </ul>
    626. 

  626. <ul class="simple nested-toc-section">zonedTimeFromTime
    627. 

  627.   <li><a class="reference" href="#zonedTimeFromTime%2CTimezone%2CTime" title="zonedTimeFromTime(zone: Timezone; time: Time): ZonedTime">zonedTimeFromTime(zone: Timezone; time: Time): ZonedTime</a></li>
    628. 

  628. 

  629. </ul>
    630. 

  630. 

  631.     </ul>
    632. 

  632.   </details>
    633. 

  633. </li>
    634. 

  634. 

  635. </ul>
    636. 

  636. 

  637.   </div>
    638. 

  638.   <div class="nine columns" id="content">
    639. 

  639.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    640. 

  640. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    641. 

  641. 

  642.     <div id="tocRoot"></div>
    643. 

  643.     
    644. 

  644.     <p class="module-desc"><p>The <tt class="docutils literal"><span class="pre"><span class="Identifier">times</span></span></tt> module contains routines and types for dealing with time using the <a class="reference external" href="https://en.wikipedia.org/wiki/Proleptic_Gregorian_calendar">proleptic Gregorian calendar</a>. It's also available for the <a class="reference external" href="backends.html#backends-the-javascript-target">JavaScript target</a>.</p>
    645. 

  645. <p>Although the <tt class="docutils literal"><span class="pre"><span class="Identifier">times</span></span></tt> module supports nanosecond time resolution, the resolution used by <tt class="docutils literal"><span class="pre"><span class="Identifier">getTime</span><span class="Punctuation">(</span><span class="Punctuation">)</span></span></tt> depends on the platform and backend (JS is limited to millisecond precision).</p>
    646. 

  646. 

  647. <h1><a class="toc-backref" id="examples" href="#examples">Examples</a></h1><p><pre class="listing"><span class="Keyword">import</span> <span class="Identifier">std</span><span class="Operator">/</span><span class="Punctuation">[</span><span class="Identifier">times</span><span class="Punctuation">,</span> <span class="Identifier">os</span><span class="Punctuation">]</span>
    648. 

  648. <span class="Comment"># Simple benchmarking</span>
    649. 

  649. <span class="Keyword">let</span> <span class="Identifier">time</span> <span class="Operator">=</span> <span class="Identifier">cpuTime</span><span class="Punctuation">(</span><span class="Punctuation">)</span>
    650. 

  650. <span class="Identifier">sleep</span><span class="Punctuation">(</span><span class="DecNumber">100</span><span class="Punctuation">)</span> <span class="Comment"># Replace this with something to be timed</span>
    651. 

  651. <span class="Identifier">echo</span> <span class="StringLit">&quot;Time taken: &quot;</span><span class="Punctuation">,</span> <span class="Identifier">cpuTime</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">-</span> <span class="Identifier">time</span>
    652. 

  652. 

  653. <span class="Comment"># Current date &amp; time</span>
    654. 

  654. <span class="Keyword">let</span> <span class="Identifier">now1</span> <span class="Operator">=</span> <span class="Identifier">now</span><span class="Punctuation">(</span><span class="Punctuation">)</span>     <span class="Comment"># Current timestamp as a DateTime in local time</span>
    655. 

  655. <span class="Keyword">let</span> <span class="Identifier">now2</span> <span class="Operator">=</span> <span class="Identifier">now</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Operator">.</span><span class="Identifier">utc</span> <span class="Comment"># Current timestamp as a DateTime in UTC</span>
    656. 

  656. <span class="Keyword">let</span> <span class="Identifier">now3</span> <span class="Operator">=</span> <span class="Identifier">getTime</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Comment"># Current timestamp as a Time</span>
    657. 

  657. 

  658. <span class="Comment"># Arithmetic using Duration</span>
    659. 

  659. <span class="Identifier">echo</span> <span class="StringLit">&quot;One hour from now      : &quot;</span><span class="Punctuation">,</span> <span class="Identifier">now</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">+</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">hours</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">)</span>
    660. 

  660. <span class="Comment"># Arithmetic using TimeInterval</span>
    661. 

  661. <span class="Identifier">echo</span> <span class="StringLit">&quot;One year from now      : &quot;</span><span class="Punctuation">,</span> <span class="Identifier">now</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">+</span> <span class="FloatNumber">1.</span><span class="Identifier">years</span>
    662. 

  662. <span class="Identifier">echo</span> <span class="StringLit">&quot;One month from now     : &quot;</span><span class="Punctuation">,</span> <span class="Identifier">now</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">+</span> <span class="FloatNumber">1.</span><span class="Identifier">months</span></pre></p>
    663. 

  663. 

  664. <h1><a class="toc-backref" id="parsing-and-formatting-dates" href="#parsing-and-formatting-dates">Parsing and Formatting Dates</a></h1><p>The <tt class="docutils literal"><span class="pre"><span class="Identifier">DateTime</span></span></tt> type can be parsed and formatted using the different <tt class="docutils literal"><span class="pre"><span class="Identifier">parse</span></span></tt> and <tt class="docutils literal"><span class="pre"><span class="Identifier">format</span></span></tt> procedures.</p>
    665. 

  665. <p><pre class="listing"><span class="Keyword">let</span> <span class="Identifier">dt</span> <span class="Operator">=</span> <span class="Identifier">parse</span><span class="Punctuation">(</span><span class="StringLit">&quot;2000-01-01&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;yyyy-MM-dd&quot;</span><span class="Punctuation">)</span>
    666. 

  666. <span class="Identifier">echo</span> <span class="Identifier">dt</span><span class="Operator">.</span><span class="Identifier">format</span><span class="Punctuation">(</span><span class="StringLit">&quot;yyyy-MM-dd&quot;</span><span class="Punctuation">)</span></pre></p>
    667. 

  667. <p>The different format patterns that are supported are documented below.</p>
    668. 

  668. <table border="1" class="docutils"><tr><th>Pattern</th><th>Description</th><th>Example</th></tr>
    669. 

  669. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">d</span></span></tt></td><td>Numeric value representing the day of the month, it will be either one or two digits long.</td><td><p><tt class="docutils literal"><span class="pre"><span class="DecNumber">1</span><span class="Operator">/</span><span class="DecNumber">04</span><span class="Operator">/</span><span class="DecNumber">2012</span> <span class="Operator">-&gt;</span> <span class="DecNumber">1</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="DecNumber">21</span><span class="Operator">/</span><span class="DecNumber">04</span><span class="Operator">/</span><span class="DecNumber">2012</span> <span class="Operator">-&gt;</span> <span class="DecNumber">21</span></span></tt><br/></p></td></tr>
    670. 

  670. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">dd</span></span></tt></td><td>Same as above, but is always two digits. </td><td><p><tt class="docutils literal"><span class="pre"><span class="DecNumber">1</span><span class="Operator">/</span><span class="DecNumber">04</span><span class="Operator">/</span><span class="DecNumber">2012</span> <span class="Operator">-&gt;</span> <span class="DecNumber">01</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="DecNumber">21</span><span class="Operator">/</span><span class="DecNumber">04</span><span class="Operator">/</span><span class="DecNumber">2012</span> <span class="Operator">-&gt;</span> <span class="DecNumber">21</span></span></tt><br/></p></td></tr>
    671. 

  671. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">ddd</span></span></tt></td><td>Three letter string which indicates the day of the week. </td><td><p><tt class="docutils literal"><span class="pre"><span class="Identifier">Saturday</span> <span class="Operator">-&gt;</span> <span class="Identifier">Sat</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="Identifier">Monday</span> <span class="Operator">-&gt;</span> <span class="Identifier">Mon</span></span></tt><br/></p></td></tr>
    672. 

  672. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">dddd</span></span></tt></td><td>Full string for the day of the week. </td><td><p><tt class="docutils literal"><span class="pre"><span class="Identifier">Saturday</span> <span class="Operator">-&gt;</span> <span class="Identifier">Saturday</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="Identifier">Monday</span> <span class="Operator">-&gt;</span> <span class="Identifier">Monday</span></span></tt><br/></p></td></tr>
    673. 

  673. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">GG</span></span></tt></td><td>The last two digits of the Iso Week-Year</td><td><p><tt class="docutils literal"><span class="pre"><span class="DecNumber">30</span><span class="Operator">/</span><span class="DecNumber">12</span><span class="Operator">/</span><span class="DecNumber">2012</span> <span class="Operator">-&gt;</span> <span class="DecNumber">13</span></span></tt><br/></p></td></tr>
    674. 

  674. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">GGGG</span></span></tt></td><td>The Iso week-calendar year padded to four digits</td><td><p><tt class="docutils literal"><span class="pre"><span class="DecNumber">30</span><span class="Operator">/</span><span class="DecNumber">12</span><span class="Operator">/</span><span class="DecNumber">2012</span> <span class="Operator">-&gt;</span> <span class="DecNumber">2013</span></span></tt><br/></p></td></tr>
    675. 

  675. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">h</span></span></tt></td><td>The hours in one digit if possible. Ranging from 1-12. </td><td><p><tt class="docutils literal"><span class="pre"><span class="DecNumber">5</span><span class="Identifier">pm</span> <span class="Operator">-&gt;</span> <span class="DecNumber">5</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="DecNumber">2</span><span class="Identifier">am</span> <span class="Operator">-&gt;</span> <span class="DecNumber">2</span></span></tt><br/></p></td></tr>
    676. 

  676. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">hh</span></span></tt></td><td>The hours in two digits always. If the hour is one digit, 0 is prepended. </td><td><p><tt class="docutils literal"><span class="pre"><span class="DecNumber">5</span><span class="Identifier">pm</span> <span class="Operator">-&gt;</span> <span class="DecNumber">05</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="DecNumber">11</span><span class="Identifier">am</span> <span class="Operator">-&gt;</span> <span class="DecNumber">11</span></span></tt><br/></p></td></tr>
    677. 

  677. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">H</span></span></tt></td><td>The hours in one digit if possible, ranging from 0-23. </td><td><p><tt class="docutils literal"><span class="pre"><span class="DecNumber">5</span><span class="Identifier">pm</span> <span class="Operator">-&gt;</span> <span class="DecNumber">17</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="DecNumber">2</span><span class="Identifier">am</span> <span class="Operator">-&gt;</span> <span class="DecNumber">2</span></span></tt><br/></p></td></tr>
    678. 

  678. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">HH</span></span></tt></td><td>The hours in two digits always. 0 is prepended if the hour is one digit. </td><td><p><tt class="docutils literal"><span class="pre"><span class="DecNumber">5</span><span class="Identifier">pm</span> <span class="Operator">-&gt;</span> <span class="DecNumber">17</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="DecNumber">2</span><span class="Identifier">am</span> <span class="Operator">-&gt;</span> <span class="DecNumber">02</span></span></tt><br/></p></td></tr>
    679. 

  679. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">m</span></span></tt></td><td>The minutes in one digit if possible. </td><td><p><tt class="docutils literal"><span class="pre"><span class="DecNumber">5</span><span class="Punctuation">:</span><span class="DecNumber">30</span> <span class="Operator">-&gt;</span> <span class="DecNumber">30</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="DecNumber">2</span><span class="Punctuation">:</span><span class="DecNumber">01</span> <span class="Operator">-&gt;</span> <span class="DecNumber">1</span></span></tt><br/></p></td></tr>
    680. 

  680. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">mm</span></span></tt></td><td>Same as above but always two digits, 0 is prepended if the minute is one digit. </td><td><p><tt class="docutils literal"><span class="pre"><span class="DecNumber">5</span><span class="Punctuation">:</span><span class="DecNumber">30</span> <span class="Operator">-&gt;</span> <span class="DecNumber">30</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="DecNumber">2</span><span class="Punctuation">:</span><span class="DecNumber">01</span> <span class="Operator">-&gt;</span> <span class="DecNumber">01</span></span></tt><br/></p></td></tr>
    681. 

  681. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">M</span></span></tt></td><td>The month in one digit if possible. </td><td><p><tt class="docutils literal"><span class="pre"><span class="Identifier">September</span> <span class="Operator">-&gt;</span> <span class="DecNumber">9</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="Identifier">December</span> <span class="Operator">-&gt;</span> <span class="DecNumber">12</span></span></tt><br/></p></td></tr>
    682. 

  682. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">MM</span></span></tt></td><td>The month in two digits always. 0 is prepended if the month value is one digit. </td><td><p><tt class="docutils literal"><span class="pre"><span class="Identifier">September</span> <span class="Operator">-&gt;</span> <span class="DecNumber">09</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="Identifier">December</span> <span class="Operator">-&gt;</span> <span class="DecNumber">12</span></span></tt><br/></p></td></tr>
    683. 

  683. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">MMM</span></span></tt></td><td>Abbreviated three-letter form of the month. </td><td><p><tt class="docutils literal"><span class="pre"><span class="Identifier">September</span> <span class="Operator">-&gt;</span> <span class="Identifier">Sep</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="Identifier">December</span> <span class="Operator">-&gt;</span> <span class="Identifier">Dec</span></span></tt><br/></p></td></tr>
    684. 

  684. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">MMMM</span></span></tt></td><td>Full month string, properly capitalized.</td><td><p><tt class="docutils literal"><span class="pre"><span class="Identifier">September</span> <span class="Operator">-&gt;</span> <span class="Identifier">September</span></span></tt><br/></p></td></tr>
    685. 

  685. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt></td><td>Seconds as one digit if possible.</td><td><p><tt class="docutils literal"><span class="pre"><span class="DecNumber">00</span><span class="Punctuation">:</span><span class="DecNumber">00</span><span class="Punctuation">:</span><span class="DecNumber">06</span> <span class="Operator">-&gt;</span> <span class="DecNumber">6</span></span></tt><br/></p></td></tr>
    686. 

  686. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">ss</span></span></tt></td><td>Same as above but always two digits. 0 is prepended if the second is one digit.</td><td><p><tt class="docutils literal"><span class="pre"><span class="DecNumber">00</span><span class="Punctuation">:</span><span class="DecNumber">00</span><span class="Punctuation">:</span><span class="DecNumber">06</span> <span class="Operator">-&gt;</span> <span class="DecNumber">06</span></span></tt><br/></p></td></tr>
    687. 

  687. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">t</span></span></tt></td><td><tt class="docutils literal"><span class="pre"><span class="Identifier">A</span></span></tt> when time is in the AM. <tt class="docutils literal"><span class="pre"><span class="Identifier">P</span></span></tt> when time is in the PM. </td><td><p><tt class="docutils literal"><span class="pre"><span class="DecNumber">5</span><span class="Identifier">pm</span> <span class="Operator">-&gt;</span> <span class="Identifier">P</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="DecNumber">2</span><span class="Identifier">am</span> <span class="Operator">-&gt;</span> <span class="Identifier">A</span></span></tt><br/></p></td></tr>
    688. 

  688. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">tt</span></span></tt></td><td>Same as above, but <tt class="docutils literal"><span class="pre"><span class="Identifier">AM</span></span></tt> and <tt class="docutils literal"><span class="pre"><span class="Identifier">PM</span></span></tt> instead of <tt class="docutils literal"><span class="pre"><span class="Identifier">A</span></span></tt> and <tt class="docutils literal"><span class="pre"><span class="Identifier">P</span></span></tt> respectively. </td><td><p><tt class="docutils literal"><span class="pre"><span class="DecNumber">5</span><span class="Identifier">pm</span> <span class="Operator">-&gt;</span> <span class="Identifier">PM</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="DecNumber">2</span><span class="Identifier">am</span> <span class="Operator">-&gt;</span> <span class="Identifier">AM</span></span></tt><br/></p></td></tr>
    689. 

  689. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">yy</span></span></tt></td><td>The last two digits of the year. When parsing, the current century is assumed.</td><td><p><tt class="docutils literal"><span class="pre"><span class="DecNumber">2012</span> <span class="Identifier">AD</span> <span class="Operator">-&gt;</span> <span class="DecNumber">12</span></span></tt><br/></p></td></tr>
    690. 

  690. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">yyyy</span></span></tt></td><td>The year, padded to at least four digits. Is always positive, even when the year is BC. When the year is more than four digits, '+' is prepended. </td><td><p><tt class="docutils literal"><span class="pre"><span class="DecNumber">2012</span> <span class="Identifier">AD</span> <span class="Operator">-&gt;</span> <span class="DecNumber">2012</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="DecNumber">24</span> <span class="Identifier">AD</span> <span class="Operator">-&gt;</span> <span class="DecNumber">0024</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="DecNumber">24</span> <span class="Identifier">BC</span> <span class="Operator">-&gt;</span> <span class="DecNumber">00024</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="DecNumber">12345</span> <span class="Identifier">AD</span> <span class="Operator">-&gt;</span> <span class="Operator">+</span><span class="DecNumber">12345</span></span></tt><br/></p></td></tr>
    691. 

  691. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">YYYY</span></span></tt></td><td>The year without any padding. Is always positive, even when the year is BC.</td><td><p><tt class="docutils literal"><span class="pre"><span class="DecNumber">2012</span> <span class="Identifier">AD</span> <span class="Operator">-&gt;</span> <span class="DecNumber">2012</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="DecNumber">24</span> <span class="Identifier">AD</span> <span class="Operator">-&gt;</span> <span class="DecNumber">24</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="DecNumber">24</span> <span class="Identifier">BC</span> <span class="Operator">-&gt;</span> <span class="DecNumber">24</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="DecNumber">12345</span> <span class="Identifier">AD</span> <span class="Operator">-&gt;</span> <span class="DecNumber">12345</span></span></tt><br/></p></td></tr>
    692. 

  692. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">uuuu</span></span></tt></td><td>The year, padded to at least four digits. Will be negative when the year is BC. When the year is more than four digits, '+' is prepended unless the year is BC.</td><td><p><tt class="docutils literal"><span class="pre"><span class="DecNumber">2012</span> <span class="Identifier">AD</span> <span class="Operator">-&gt;</span> <span class="DecNumber">2012</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="DecNumber">24</span> <span class="Identifier">AD</span> <span class="Operator">-&gt;</span> <span class="DecNumber">0024</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="DecNumber">24</span> <span class="Identifier">BC</span> <span class="Operator">-&gt;</span> <span class="Operator">-</span><span class="DecNumber">0023</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="DecNumber">12345</span> <span class="Identifier">AD</span> <span class="Operator">-&gt;</span> <span class="Operator">+</span><span class="DecNumber">12345</span></span></tt><br/></p></td></tr>
    693. 

  693. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">UUUU</span></span></tt></td><td>The year without any padding. Will be negative when the year is BC.</td><td><p><tt class="docutils literal"><span class="pre"><span class="DecNumber">2012</span> <span class="Identifier">AD</span> <span class="Operator">-&gt;</span> <span class="DecNumber">2012</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="DecNumber">24</span> <span class="Identifier">AD</span> <span class="Operator">-&gt;</span> <span class="DecNumber">24</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="DecNumber">24</span> <span class="Identifier">BC</span> <span class="Operator">-&gt;</span> <span class="Operator">-</span><span class="DecNumber">23</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="DecNumber">12345</span> <span class="Identifier">AD</span> <span class="Operator">-&gt;</span> <span class="DecNumber">12345</span></span></tt><br/></p></td></tr>
    694. 

  694. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">V</span></span></tt></td><td>The Iso Week-Number as one or two digits </td><td><p><tt class="docutils literal"><span class="pre"><span class="DecNumber">3</span><span class="Operator">/</span><span class="DecNumber">2</span><span class="Operator">/</span><span class="DecNumber">2012</span> <span class="Operator">-&gt;</span> <span class="DecNumber">5</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="DecNumber">1</span><span class="Operator">/</span><span class="DecNumber">4</span><span class="Operator">/</span><span class="DecNumber">2012</span> <span class="Operator">-&gt;</span> <span class="DecNumber">13</span></span></tt><br/></p></td></tr>
    695. 

  695. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">VV</span></span></tt></td><td>The Iso Week-Number as two digits always. 0 is prepended if one digit. </td><td><p><tt class="docutils literal"><span class="pre"><span class="DecNumber">3</span><span class="Operator">/</span><span class="DecNumber">2</span><span class="Operator">/</span><span class="DecNumber">2012</span> <span class="Operator">-&gt;</span> <span class="DecNumber">05</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="DecNumber">1</span><span class="Operator">/</span><span class="DecNumber">4</span><span class="Operator">/</span><span class="DecNumber">2012</span> <span class="Operator">-&gt;</span> <span class="DecNumber">13</span></span></tt><br/></p></td></tr>
    696. 

  696. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">z</span></span></tt></td><td>Displays the timezone offset from UTC. </td><td><p><tt class="docutils literal"><span class="pre"><span class="Identifier">UTC</span><span class="Operator">+</span><span class="DecNumber">7</span> <span class="Operator">-&gt;</span> <span class="Operator">+</span><span class="DecNumber">7</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="Identifier">UTC</span><span class="Operator">-</span><span class="DecNumber">5</span> <span class="Operator">-&gt;</span> <span class="Operator">-</span><span class="DecNumber">5</span></span></tt><br/></p></td></tr>
    697. 

  697. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">zz</span></span></tt></td><td>Same as above but with leading 0. </td><td><p><tt class="docutils literal"><span class="pre"><span class="Identifier">UTC</span><span class="Operator">+</span><span class="DecNumber">7</span> <span class="Operator">-&gt;</span> <span class="Operator">+</span><span class="DecNumber">07</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="Identifier">UTC</span><span class="Operator">-</span><span class="DecNumber">5</span> <span class="Operator">-&gt;</span> <span class="Operator">-</span><span class="DecNumber">05</span></span></tt><br/></p></td></tr>
    698. 

  698. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">zzz</span></span></tt></td><td>Same as above but with <tt class="docutils literal"><span class="pre"><span class="Punctuation">:</span><span class="Identifier">mm</span></span></tt> where <em>mm</em> represents minutes. </td><td><p><tt class="docutils literal"><span class="pre"><span class="Identifier">UTC</span><span class="Operator">+</span><span class="DecNumber">7</span> <span class="Operator">-&gt;</span> <span class="Operator">+</span><span class="DecNumber">07</span><span class="Punctuation">:</span><span class="DecNumber">00</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="Identifier">UTC</span><span class="Operator">-</span><span class="DecNumber">5</span> <span class="Operator">-&gt;</span> <span class="Operator">-</span><span class="DecNumber">05</span><span class="Punctuation">:</span><span class="DecNumber">00</span></span></tt><br/></p></td></tr>
    699. 

  699. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">ZZZ</span></span></tt></td><td>Same as above but with <tt class="docutils literal"><span class="pre"><span class="Identifier">mm</span></span></tt> where <em>mm</em> represents minutes. </td><td><p><tt class="docutils literal"><span class="pre"><span class="Identifier">UTC</span><span class="Operator">+</span><span class="DecNumber">7</span> <span class="Operator">-&gt;</span> <span class="Operator">+</span><span class="DecNumber">0700</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="Identifier">UTC</span><span class="Operator">-</span><span class="DecNumber">5</span> <span class="Operator">-&gt;</span> <span class="Operator">-</span><span class="DecNumber">0500</span></span></tt><br/></p></td></tr>
    700. 

  700. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">zzzz</span></span></tt></td><td>Same as above but with <tt class="docutils literal"><span class="pre"><span class="Punctuation">:</span><span class="Identifier">ss</span></span></tt> where <em>ss</em> represents seconds. </td><td><p><tt class="docutils literal"><span class="pre"><span class="Identifier">UTC</span><span class="Operator">+</span><span class="DecNumber">7</span> <span class="Operator">-&gt;</span> <span class="Operator">+</span><span class="DecNumber">07</span><span class="Punctuation">:</span><span class="DecNumber">00</span><span class="Punctuation">:</span><span class="DecNumber">00</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="Identifier">UTC</span><span class="Operator">-</span><span class="DecNumber">5</span> <span class="Operator">-&gt;</span> <span class="Operator">-</span><span class="DecNumber">05</span><span class="Punctuation">:</span><span class="DecNumber">00</span><span class="Punctuation">:</span><span class="DecNumber">00</span></span></tt><br/></p></td></tr>
    701. 

  701. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">ZZZZ</span></span></tt></td><td>Same as above but with <tt class="docutils literal"><span class="pre"><span class="Identifier">ss</span></span></tt> where <em>ss</em> represents seconds. </td><td><p><tt class="docutils literal"><span class="pre"><span class="Identifier">UTC</span><span class="Operator">+</span><span class="DecNumber">7</span> <span class="Operator">-&gt;</span> <span class="Operator">+</span><span class="DecNumber">070000</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="Identifier">UTC</span><span class="Operator">-</span><span class="DecNumber">5</span> <span class="Operator">-&gt;</span> <span class="Operator">-</span><span class="DecNumber">050000</span></span></tt><br/></p></td></tr>
    702. 

  702. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">g</span></span></tt></td><td>Era: AD or BC </td><td><p><tt class="docutils literal"><span class="pre"><span class="DecNumber">300</span> <span class="Identifier">AD</span> <span class="Operator">-&gt;</span> <span class="Identifier">AD</span></span></tt><br/><tt class="docutils literal"><span class="pre"><span class="DecNumber">300</span> <span class="Identifier">BC</span> <span class="Operator">-&gt;</span> <span class="Identifier">BC</span></span></tt><br/></p></td></tr>
    703. 

  703. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">fff</span></span></tt></td><td>Milliseconds display</td><td><p><tt class="docutils literal"><span class="pre"><span class="DecNumber">1000000</span> <span class="Identifier">nanoseconds</span> <span class="Operator">-&gt;</span> <span class="DecNumber">1</span></span></tt><br/></p></td></tr>
    704. 

  704. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">ffffff</span></span></tt></td><td>Microseconds display</td><td><p><tt class="docutils literal"><span class="pre"><span class="DecNumber">1000000</span> <span class="Identifier">nanoseconds</span> <span class="Operator">-&gt;</span> <span class="DecNumber">1000</span></span></tt><br/></p></td></tr>
    705. 

  705. <tr><td><tt class="docutils literal"><span class="pre"><span class="Identifier">fffffffff</span></span></tt></td><td>Nanoseconds display</td><td><p><tt class="docutils literal"><span class="pre"><span class="DecNumber">1000000</span> <span class="Identifier">nanoseconds</span> <span class="Operator">-&gt;</span> <span class="DecNumber">1000000</span></span></tt><br/></p></td></tr>
    706. 

  706. </table><p>Other strings can be inserted by putting them in <tt class="docutils literal"><span class="pre"><span class="CharLit">''</span></span></tt>. For example <tt class="docutils literal"><span class="pre"><span class="Identifier">hh</span><span class="CharLit">'-&gt;'</span><span class="Identifier">mm</span></span></tt> will give <tt class="docutils literal"><span class="pre"><span class="DecNumber">01</span><span class="Operator">-&gt;</span><span class="DecNumber">56</span></span></tt>.  In addition to spaces, the following characters can be inserted without quoting them: <tt class="docutils literal"><span class="pre"><span class="Punctuation">:</span></span></tt> <tt class="docutils literal"><span class="pre"><span class="Operator">-</span></span></tt> <tt class="docutils literal"><span class="pre"><span class="Punctuation">,</span></span></tt> <tt class="docutils literal"><span class="pre"><span class="Operator">.</span></span></tt> <tt class="docutils literal"><span class="pre"><span class="Punctuation">(</span></span></tt> <tt class="docutils literal"><span class="pre"><span class="Punctuation">)</span></span></tt> <tt class="docutils literal"><span class="pre"><span class="Operator">/</span></span></tt> <tt class="docutils literal"><span class="pre"><span class="Punctuation">[</span></span></tt> <tt class="docutils literal"><span class="pre"><span class="Punctuation">]</span></span></tt>. A literal <tt class="docutils literal"><span class="pre"><span class="CharLit">'</span></span></tt> can be specified with <tt class="docutils literal"><span class="pre"><span class="CharLit">''</span></span></tt>.</p>
    707. 

  707. <p>However you don't need to necessarily separate format patterns, as an unambiguous format string like <tt class="docutils literal"><span class="pre"><span class="Identifier">yyyyMMddhhmmss</span></span></tt> is also valid (although only for years in the range 1..9999).</p>
    708. 

  708. 

  709. <h1><a class="toc-backref" id="duration-vs-timeinterval" href="#duration-vs-timeinterval">Duration vs TimeInterval</a></h1><p>The <tt class="docutils literal"><span class="pre"><span class="Identifier">times</span></span></tt> module exports two similar types that are both used to represent some amount of time: <a class="reference external" href="#Duration">Duration</a> and <a class="reference external" href="#TimeInterval">TimeInterval</a>. This section explains how they differ and when one should be preferred over the other (short answer: use <tt class="docutils literal"><span class="pre"><span class="Identifier">Duration</span></span></tt> unless support for months and years is needed).</p>
    710. 

  710. 

  711. <h2><a class="toc-backref" id="duration-vs-timeinterval-duration" href="#duration-vs-timeinterval-duration">Duration</a></h2><p>A <tt class="docutils literal"><span class="pre"><span class="Identifier">Duration</span></span></tt> represents a duration of time stored as seconds and nanoseconds. A <tt class="docutils literal"><span class="pre"><span class="Identifier">Duration</span></span></tt> is always fully normalized, so <tt class="docutils literal"><span class="pre"><span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">hours</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">)</span></span></tt> and <tt class="docutils literal"><span class="pre"><span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">minutes</span> <span class="Operator">=</span> <span class="DecNumber">60</span><span class="Punctuation">)</span></span></tt> are equivalent.</p>
    712. 

  712. <p>Arithmetic with a <tt class="docutils literal"><span class="pre"><span class="Identifier">Duration</span></span></tt> is very fast, especially when used with the <tt class="docutils literal"><span class="pre"><span class="Identifier">Time</span></span></tt> type, since it only involves basic arithmetic. Because <tt class="docutils literal"><span class="pre"><span class="Identifier">Duration</span></span></tt> is more performant and easier to understand it should generally preferred.</p>
    713. 

  713. 

  714. <h2><a class="toc-backref" id="duration-vs-timeinterval-timeinterval" href="#duration-vs-timeinterval-timeinterval">TimeInterval</a></h2><p>A <tt class="docutils literal"><span class="pre"><span class="Identifier">TimeInterval</span></span></tt> represents an amount of time expressed in calendar units, for example &quot;1 year and 2 days&quot;. Since some units cannot be normalized (the length of a year is different for leap years for example), the <tt class="docutils literal"><span class="pre"><span class="Identifier">TimeInterval</span></span></tt> type uses separate fields for every unit. The <tt class="docutils literal"><span class="pre"><span class="Identifier">TimeInterval</span></span></tt>'s returned from this module generally don't normalize <strong>anything</strong>, so even units that could be normalized (like seconds, milliseconds and so on) are left untouched.</p>
    715. 

  715. <p>Arithmetic with a <tt class="docutils literal"><span class="pre"><span class="Identifier">TimeInterval</span></span></tt> can be very slow, because it requires timezone information.</p>
    716. 

  716. <p>Since it's slower and more complex, the <tt class="docutils literal"><span class="pre"><span class="Identifier">TimeInterval</span></span></tt> type should be avoided unless the program explicitly needs the features it offers that <tt class="docutils literal"><span class="pre"><span class="Identifier">Duration</span></span></tt> doesn't have.</p>
    717. 

  717. 

  718. <h2><a class="toc-backref" id="duration-vs-timeinterval-how-long-is-a-dayqmark" href="#duration-vs-timeinterval-how-long-is-a-dayqmark">How long is a day?</a></h2><p>It should be especially noted that the handling of days differs between <tt class="docutils literal"><span class="pre"><span class="Identifier">TimeInterval</span></span></tt> and <tt class="docutils literal"><span class="pre"><span class="Identifier">Duration</span></span></tt>. The <tt class="docutils literal"><span class="pre"><span class="Identifier">Duration</span></span></tt> type always treats a day as exactly 86400 seconds. For <tt class="docutils literal"><span class="pre"><span class="Identifier">TimeInterval</span></span></tt>, it's more complex.</p>
    719. 

  719. <p>As an example, consider the amount of time between these two timestamps, both in the same timezone:</p>
    720. 

  720. <ul class="simple"><li>2018-03-25T12:00+02:00</li>
    721. 

  721. <li>2018-03-26T12:00+01:00</li>
    722. 

  722. </ul>
    723. 

  723. <p>If only the date &amp; time is considered, it appears that exactly one day has passed. However, the UTC offsets are different, which means that the UTC offset was changed somewhere in between. This happens twice each year for timezones that use daylight savings time. Because of this change, the amount of time that has passed is actually 25 hours.</p>
    724. 

  724. <p>The <tt class="docutils literal"><span class="pre"><span class="Identifier">TimeInterval</span></span></tt> type uses calendar units, and will say that exactly one day has passed. The <tt class="docutils literal"><span class="pre"><span class="Identifier">Duration</span></span></tt> type on the other hand normalizes everything to seconds, and will therefore say that 90000 seconds has passed, which is the same as 25 hours.</p>
    725. 

  725. 

  726. <h1><a class="toc-backref" id="see-also" href="#see-also">See also</a></h1><ul class="simple"><li><a class="reference external" href="monotimes.html">monotimes module</a></li>
    727. 

  727. </ul>
    728. 

  728. </p>
    729. 

  729.     <div class="section" id="6">
    730. 

  730.   <h1><a class="toc-backref" href="#6">Imports</a></h1>
    731. 

  731.   <dl class="item">
    732. 

  732.     <a class="reference external" href="strutils.html">strutils</a>, <a class="reference external" href="math.html">math</a>, <a class="reference external" href="options.html">options</a>, <a class="reference external" href="since.html">since</a>, <a class="reference external" href="assertions.html">assertions</a>, <a class="reference external" href="posix.html">posix</a>
    733. 

  733.   </dl>
    734. 

  734. </div>
    735. 

  735. <div class="section" id="7">
    736. 

  736.   <h1><a class="toc-backref" href="#7">Types</a></h1>
    737. 

  737.   <dl class="item">
    738. 

  738.     <div id="DateTime">
    739. 

  739.   <dt><pre><a href="times.html#DateTime"><span class="Identifier">DateTime</span></a> <span class="Other">=</span> <span class="Keyword">object</span> <span class="Keyword">of</span> <a href="system.html#RootObj"><span class="Identifier">RootObj</span></a></pre></dt>
    740. 

  740.   <dd>
    741. 

  741.     
    742. 

  742.     
    743. 

  743. Represents a time in different parts. Although this type can represent leap seconds, they are generally not supported in this module. They are not ignored, but the <tt class="docutils literal"><span class="pre"><span class="Identifier">DateTime</span></span></tt>'s returned by procedures in this module will never have a leap second.
    744. 

  744.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L316" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    745. 

  745. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L316" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    746. 

  746. 

  747.   </dd>
    748. 

  748. </div>
    749. 

  749. <div id="DateTimeLocale">
    750. 

  750.   <dt><pre><a href="times.html#DateTimeLocale"><span class="Identifier">DateTimeLocale</span></a> <span class="Other">=</span> <span class="Keyword">object</span>
    751. 

  751.   <span class="Identifier">MMM</span><span class="Operator">*</span><span class="Other">:</span> <a href="system.html#array"><span class="Identifier">array</span></a><span class="Other">[</span><span class="Identifier">mJan</span> <span class="Operator">..</span> <span class="Identifier">mDec</span><span class="Other">,</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">]</span>
    752. 

  752.   <span class="Identifier">MMMM</span><span class="Operator">*</span><span class="Other">:</span> <a href="system.html#array"><span class="Identifier">array</span></a><span class="Other">[</span><span class="Identifier">mJan</span> <span class="Operator">..</span> <span class="Identifier">mDec</span><span class="Other">,</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">]</span>
    753. 

  753.   <span class="Identifier">ddd</span><span class="Operator">*</span><span class="Other">:</span> <a href="system.html#array"><span class="Identifier">array</span></a><span class="Other">[</span><span class="Identifier">dMon</span> <span class="Operator">..</span> <span class="Identifier">dSun</span><span class="Other">,</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">]</span>
    754. 

  754.   <span class="Identifier">dddd</span><span class="Operator">*</span><span class="Other">:</span> <a href="system.html#array"><span class="Identifier">array</span></a><span class="Other">[</span><span class="Identifier">dMon</span> <span class="Operator">..</span> <span class="Identifier">dSun</span><span class="Other">,</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">]</span></pre></dt>
    755. 

  755.   <dd>
    756. 

  756.     
    757. 

  757.     
    758. 

  758.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1548" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    759. 

  759. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1548" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    760. 

  760. 

  761.   </dd>
    762. 

  762. </div>
    763. 

  763. <div id="Duration">
    764. 

  764.   <dt><pre><a href="times.html#Duration"><span class="Identifier">Duration</span></a> <span class="Other">=</span> <span class="Keyword">object</span></pre></dt>
    765. 

  765.   <dd>
    766. 

  766.     
    767. 

  767.     <p>Represents a fixed duration of time, meaning a duration that has constant length independent of the context.</p>
    768. 

  768. <p>To create a new <tt class="docutils literal"><span class="pre"><span class="Identifier">Duration</span></span></tt>, use <a class="reference external" href="#initDuration,int64,int64,int64,int64,int64,int64,int64,int64">initDuration</a>. Instead of trying to access the private attributes, use <a class="reference external" href="#inSeconds,Duration">inSeconds</a> for converting to seconds and <a class="reference external" href="#inNanoseconds,Duration">inNanoseconds</a> for converting to nanoseconds.</p>
    769. 

  769. 

  770.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L334" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    771. 

  771. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L334" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    772. 

  772. 

  773.   </dd>
    774. 

  774. </div>
    775. 

  775. <div id="DurationParts">
    776. 

  776.   <dt><pre><a href="times.html#DurationParts"><span class="Identifier">DurationParts</span></a> <span class="Other">=</span> <a href="system.html#array"><span class="Identifier">array</span></a><span class="Other">[</span><span class="Identifier">FixedTimeUnit</span><span class="Other">,</span> <a href="system.html#int64"><span class="Identifier">int64</span></a><span class="Other">]</span></pre></dt>
    777. 

  777.   <dd>
    778. 

  778.     
    779. 

  779.     
    780. 

  780.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L398" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    781. 

  781. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L398" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    782. 

  782. 

  783.   </dd>
    784. 

  784. </div>
    785. 

  785. <div id="FixedTimeUnit">
    786. 

  786.   <dt><pre><a href="times.html#FixedTimeUnit"><span class="Identifier">FixedTimeUnit</span></a> <span class="Other">=</span> <a href="system.html#range"><span class="Identifier">range</span></a><span class="Other">[</span><span class="Identifier">Nanoseconds</span> <span class="Operator">..</span> <span class="Identifier">Weeks</span><span class="Other">]</span></pre></dt>
    787. 

  787.   <dd>
    788. 

  788.     
    789. 

  789.     
    790. 

  790. Subrange of <tt class="docutils literal"><span class="pre"><span class="Identifier">TimeUnit</span></span></tt> that only includes units of fixed duration. These are the units that can be represented by a <tt class="docutils literal"><span class="pre"><span class="Identifier">Duration</span></span></tt>.
    791. 

  791.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L349" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    792. 

  792. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L349" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    793. 

  793. 

  794.   </dd>
    795. 

  795. </div>
    796. 

  796. <div id="HourRange">
    797. 

  797.   <dt><pre><a href="times.html#HourRange"><span class="Identifier">HourRange</span></a> <span class="Other">=</span> <a href="system.html#range"><span class="Identifier">range</span></a><span class="Other">[</span><span class="DecNumber">0</span> <span class="Operator">..</span> <span class="DecNumber">23</span><span class="Other">]</span></pre></dt>
    798. 

  798.   <dd>
    799. 

  799.     
    800. 

  800.     
    801. 

  801.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L297" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    802. 

  802. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L297" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    803. 

  803. 

  804.   </dd>
    805. 

  805. </div>
    806. 

  806. <div id="IsoWeekRange">
    807. 

  807.   <dt><pre><a href="times.html#IsoWeekRange"><span class="Identifier">IsoWeekRange</span></a> <span class="Other">=</span> <a href="system.html#range"><span class="Identifier">range</span></a><span class="Other">[</span><span class="DecNumber">1</span> <span class="Operator">..</span> <span class="DecNumber">53</span><span class="Other">]</span></pre></dt>
    808. 

  808.   <dd>
    809. 

  809.     
    810. 

  810.     An ISO 8601 calendar week number.
    811. 

  811.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L305" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    812. 

  812. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L305" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    813. 

  813. 

  814.   </dd>
    815. 

  815. </div>
    816. 

  816. <div id="IsoYear">
    817. 

  817.   <dt><pre><a href="times.html#IsoYear"><span class="Identifier">IsoYear</span></a> <span class="Other">=</span> <span class="Keyword">distinct</span> <a href="system.html#int"><span class="Identifier">int</span></a></pre></dt>
    818. 

  818.   <dd>
    819. 

  819.     
    820. 

  820.     An ISO 8601 calendar year number.<div class="admonition admonition-warning"><span class="admonition-warning-text"><b>Warning:</b></span>
    821. 

  821. The ISO week-based year can correspond to the following or previous year from 29 December to January 3.</div>
    822. 

  822. 

  823.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L307" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    824. 

  824. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L307" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    825. 

  825. 

  826.   </dd>
    827. 

  827. </div>
    828. 

  828. <div id="MinuteRange">
    829. 

  829.   <dt><pre><a href="times.html#MinuteRange"><span class="Identifier">MinuteRange</span></a> <span class="Other">=</span> <a href="system.html#range"><span class="Identifier">range</span></a><span class="Other">[</span><span class="DecNumber">0</span> <span class="Operator">..</span> <span class="DecNumber">59</span><span class="Other">]</span></pre></dt>
    830. 

  830.   <dd>
    831. 

  831.     
    832. 

  832.     
    833. 

  833.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L298" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    834. 

  834. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L298" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    835. 

  835. 

  836.   </dd>
    837. 

  837. </div>
    838. 

  838. <div id="Month">
    839. 

  839.   <dt><pre><a href="times.html#Month"><span class="Identifier">Month</span></a> <span class="Other">=</span> <span class="Keyword">enum</span>
    840. 

  840.   <span class="Identifier">mJan</span> <span class="Other">=</span> <span class="Other">(</span><span class="DecNumber">1</span><span class="Other">,</span> <span class="StringLit">&quot;January&quot;</span><span class="Other">)</span><span class="Other">,</span> <span class="Identifier">mFeb</span> <span class="Other">=</span> <span class="StringLit">&quot;February&quot;</span><span class="Other">,</span> <span class="Identifier">mMar</span> <span class="Other">=</span> <span class="StringLit">&quot;March&quot;</span><span class="Other">,</span> <span class="Identifier">mApr</span> <span class="Other">=</span> <span class="StringLit">&quot;April&quot;</span><span class="Other">,</span>
    841. 

  841.   <span class="Identifier">mMay</span> <span class="Other">=</span> <span class="StringLit">&quot;May&quot;</span><span class="Other">,</span> <span class="Identifier">mJun</span> <span class="Other">=</span> <span class="StringLit">&quot;June&quot;</span><span class="Other">,</span> <span class="Identifier">mJul</span> <span class="Other">=</span> <span class="StringLit">&quot;July&quot;</span><span class="Other">,</span> <span class="Identifier">mAug</span> <span class="Other">=</span> <span class="StringLit">&quot;August&quot;</span><span class="Other">,</span>
    842. 

  842.   <span class="Identifier">mSep</span> <span class="Other">=</span> <span class="StringLit">&quot;September&quot;</span><span class="Other">,</span> <span class="Identifier">mOct</span> <span class="Other">=</span> <span class="StringLit">&quot;October&quot;</span><span class="Other">,</span> <span class="Identifier">mNov</span> <span class="Other">=</span> <span class="StringLit">&quot;November&quot;</span><span class="Other">,</span> <span class="Identifier">mDec</span> <span class="Other">=</span> <span class="StringLit">&quot;December&quot;</span></pre></dt>
    843. 

  843.   <dd>
    844. 

  844.     
    845. 

  845.     Represents a month. Note that the enum starts at <tt class="docutils literal"><span class="pre"><span class="DecNumber">1</span></span></tt>, so <tt class="docutils literal"><span class="pre"><span class="Identifier">ord</span><span class="Punctuation">(</span><span class="Identifier">month</span><span class="Punctuation">)</span></span></tt> will give the month number in the range <tt class="docutils literal"><span class="pre"><span class="FloatNumber">1.</span><span class="Operator">.</span><span class="DecNumber">12</span></span></tt>.
    846. 

  846.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L270" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    847. 

  847. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L270" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    848. 

  848. 

  849.   </dd>
    850. 

  850. </div>
    851. 

  851. <div id="MonthdayRange">
    852. 

  852.   <dt><pre><a href="times.html#MonthdayRange"><span class="Identifier">MonthdayRange</span></a> <span class="Other">=</span> <a href="system.html#range"><span class="Identifier">range</span></a><span class="Other">[</span><span class="DecNumber">1</span> <span class="Operator">..</span> <span class="DecNumber">31</span><span class="Other">]</span></pre></dt>
    853. 

  853.   <dd>
    854. 

  854.     
    855. 

  855.     
    856. 

  856.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L296" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    857. 

  857. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L296" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    858. 

  858. 

  859.   </dd>
    860. 

  860. </div>
    861. 

  861. <div id="NanosecondRange">
    862. 

  862.   <dt><pre><a href="times.html#NanosecondRange"><span class="Identifier">NanosecondRange</span></a> <span class="Other">=</span> <a href="system.html#range"><span class="Identifier">range</span></a><span class="Other">[</span><span class="DecNumber">0</span> <span class="Operator">..</span> <span class="DecNumber">999999999</span><span class="Other">]</span></pre></dt>
    863. 

  863.   <dd>
    864. 

  864.     
    865. 

  865.     
    866. 

  866.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L303" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    867. 

  867. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L303" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    868. 

  868. 

  869.   </dd>
    870. 

  870. </div>
    871. 

  871. <div id="SecondRange">
    872. 

  872.   <dt><pre><a href="times.html#SecondRange"><span class="Identifier">SecondRange</span></a> <span class="Other">=</span> <a href="system.html#range"><span class="Identifier">range</span></a><span class="Other">[</span><span class="DecNumber">0</span> <span class="Operator">..</span> <span class="DecNumber">60</span><span class="Other">]</span></pre></dt>
    873. 

  873.   <dd>
    874. 

  874.     
    875. 

  875.     
    876. 

  876. Includes the value 60 to allow for a leap second. Note however that the <tt class="docutils literal"><span class="pre"><span class="Identifier">second</span></span></tt> of a <tt class="docutils literal"><span class="pre"><span class="Identifier">DateTime</span></span></tt> will never be a leap second.
    877. 

  877.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L299" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    878. 

  878. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L299" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    879. 

  879. 

  880.   </dd>
    881. 

  881. </div>
    882. 

  882. <div id="Time">
    883. 

  883.   <dt><pre><a href="times.html#Time"><span class="Identifier">Time</span></a> <span class="Other">=</span> <span class="Keyword">object</span></pre></dt>
    884. 

  884.   <dd>
    885. 

  885.     
    886. 

  886.     Represents a point in time.
    887. 

  887.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L312" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    888. 

  888. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L312" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    889. 

  889. 

  890.   </dd>
    891. 

  891. </div>
    892. 

  892. <div id="TimeFormat">
    893. 

  893.   <dt><pre><a href="times.html#TimeFormat"><span class="Identifier">TimeFormat</span></a> <span class="Other">=</span> <span class="Keyword">object</span>
    894. 

  894.   <span class="Comment">## \</span>
    895. 

  895.   <span class="Comment">## Contains the patterns encoded as bytes.</span>
    896. 

  896.   <span class="Comment">## Literal values are encoded in a special way.</span>
    897. 

  897.   <span class="Comment">## They start with `Lit.byte`, then the length of the literal, then the</span>
    898. 

  898.   <span class="Comment">## raw char values of the literal. For example, the literal `foo` would</span>
    899. 

  899.   <span class="Comment">## be encoded as `@[Lit.byte, 3.byte, 'f'.byte, 'o'.byte, 'o'.byte]`.</span></pre></dt>
    900. 

  900.   <dd>
    901. 

  901.     
    902. 

  902.     <p>Represents a format for parsing and printing time types.</p>
    903. 

  903. <p>To create a new <tt class="docutils literal"><span class="pre"><span class="Identifier">TimeFormat</span></span></tt> use <a class="reference external" href="#initTimeFormat,string">initTimeFormat proc</a>.</p>
    904. 

  904. 

  905.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1606" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    906. 

  906. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1606" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    907. 

  907. 

  908.   </dd>
    909. 

  909. </div>
    910. 

  910. <div id="TimeFormatParseError">
    911. 

  911.   <dt><pre><a href="times.html#TimeFormatParseError"><span class="Identifier">TimeFormatParseError</span></a> <span class="Other">=</span> <span class="Keyword">object</span> <span class="Keyword">of</span> <a href="exceptions.html#ValueError"><span class="Identifier">ValueError</span></a></pre></dt>
    912. 

  912.   <dd>
    913. 

  913.     
    914. 

  914.     
    915. 

  915. Raised when parsing a <tt class="docutils literal"><span class="pre"><span class="Identifier">TimeFormat</span></span></tt> string fails.
    916. 

  916.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1622" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    917. 

  917. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1622" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    918. 

  918. 

  919.   </dd>
    920. 

  920. </div>
    921. 

  921. <div id="TimeInterval">
    922. 

  922.   <dt><pre><a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a> <span class="Other">=</span> <span class="Keyword">object</span>
    923. 

  923.   <span class="Identifier">nanoseconds</span><span class="Operator">*</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a>          <span class="Comment">## The number of nanoseconds</span>
    924. 

  924.   <span class="Identifier">microseconds</span><span class="Operator">*</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a>         <span class="Comment">## The number of microseconds</span>
    925. 

  925.   <span class="Identifier">milliseconds</span><span class="Operator">*</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a>         <span class="Comment">## The number of milliseconds</span>
    926. 

  926.   <span class="Identifier">seconds</span><span class="Operator">*</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a>              <span class="Comment">## The number of seconds</span>
    927. 

  927.   <span class="Identifier">minutes</span><span class="Operator">*</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a>              <span class="Comment">## The number of minutes</span>
    928. 

  928.   <span class="Identifier">hours</span><span class="Operator">*</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a>                <span class="Comment">## The number of hours</span>
    929. 

  929.   <span class="Identifier">days</span><span class="Operator">*</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a>                 <span class="Comment">## The number of days</span>
    930. 

  930.   <span class="Identifier">weeks</span><span class="Operator">*</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a>                <span class="Comment">## The number of weeks</span>
    931. 

  931.   <span class="Identifier">months</span><span class="Operator">*</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a>               <span class="Comment">## The number of months</span>
    932. 

  932.   <span class="Identifier">years</span><span class="Operator">*</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a>                <span class="Comment">## The number of years</span></pre></dt>
    933. 

  933.   <dd>
    934. 

  934.     
    935. 

  935.     <p>
    936. 

  936. Represents a non-fixed duration of time. Can be used to add and subtract non-fixed time units from a <a class="reference external" href="#DateTime">DateTime</a> or <a class="reference external" href="#Time">Time</a>.</p>
    937. 

  937. <p>Create a new <tt class="docutils literal"><span class="pre"><span class="Identifier">TimeInterval</span></span></tt> with <a class="reference external" href="#initTimeInterval,int,int,int,int,int,int,int,int,int,int">initTimeInterval proc</a>.</p>
    938. 

  938. <p>Note that <tt class="docutils literal"><span class="pre"><span class="Identifier">TimeInterval</span></span></tt> doesn't represent a fixed duration of time, since the duration of some units depend on the context (e.g a year can be either 365 or 366 days long). The non-fixed time units are years, months, days and week.</p>
    939. 

  939. <p>Note that <tt class="docutils literal"><span class="pre"><span class="Identifier">TimeInterval</span></span></tt>'s returned from the <tt class="docutils literal"><span class="pre"><span class="Identifier">times</span></span></tt> module are never normalized. If you want to normalize a time unit, <a class="reference external" href="#Duration">Duration</a> should be used instead.</p>
    940. 

  940. 

  941.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L353" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    942. 

  942. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L353" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    943. 

  943. 

  944.   </dd>
    945. 

  945. </div>
    946. 

  946. <div id="TimeIntervalParts">
    947. 

  947.   <dt><pre><a href="times.html#TimeIntervalParts"><span class="Identifier">TimeIntervalParts</span></a> <span class="Other">=</span> <a href="system.html#array"><span class="Identifier">array</span></a><span class="Other">[</span><span class="Identifier">TimeUnit</span><span class="Other">,</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">]</span></pre></dt>
    948. 

  948.   <dd>
    949. 

  949.     
    950. 

  950.     
    951. 

  951.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L399" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    952. 

  952. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L399" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    953. 

  953. 

  954.   </dd>
    955. 

  955. </div>
    956. 

  956. <div id="TimeParseError">
    957. 

  957.   <dt><pre><a href="times.html#TimeParseError"><span class="Identifier">TimeParseError</span></a> <span class="Other">=</span> <span class="Keyword">object</span> <span class="Keyword">of</span> <a href="exceptions.html#ValueError"><span class="Identifier">ValueError</span></a></pre></dt>
    958. 

  958.   <dd>
    959. 

  959.     
    960. 

  960.     
    961. 

  961. Raised when parsing input using a <tt class="docutils literal"><span class="pre"><span class="Identifier">TimeFormat</span></span></tt> fails.
    962. 

  962.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1619" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    963. 

  963. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1619" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    964. 

  964. 

  965.   </dd>
    966. 

  966. </div>
    967. 

  967. <div id="TimeUnit">
    968. 

  968.   <dt><pre><a href="times.html#TimeUnit"><span class="Identifier">TimeUnit</span></a> <span class="Other">=</span> <span class="Keyword">enum</span>
    969. 

  969.   <span class="Identifier">Nanoseconds</span><span class="Other">,</span> <span class="Identifier">Microseconds</span><span class="Other">,</span> <span class="Identifier">Milliseconds</span><span class="Other">,</span> <span class="Identifier">Seconds</span><span class="Other">,</span> <span class="Identifier">Minutes</span><span class="Other">,</span> <span class="Identifier">Hours</span><span class="Other">,</span> <span class="Identifier">Days</span><span class="Other">,</span> <span class="Identifier">Weeks</span><span class="Other">,</span>
    970. 

  970.   <span class="Identifier">Months</span><span class="Other">,</span> <span class="Identifier">Years</span></pre></dt>
    971. 

  971.   <dd>
    972. 

  972.     
    973. 

  973.     Different units of time.
    974. 

  974.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L345" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    975. 

  975. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L345" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    976. 

  976. 

  977.   </dd>
    978. 

  978. </div>
    979. 

  979. <div id="Timezone">
    980. 

  980.   <dt><pre><a href="times.html#Timezone"><span class="Identifier">Timezone</span></a> <span class="Other">=</span> <span class="Keyword">ref</span> <span class="Keyword">object</span></pre></dt>
    981. 

  981.   <dd>
    982. 

  982.     
    983. 

  983.     
    984. 

  984. Timezone interface for supporting <a class="reference external" href="#DateTime">DateTime</a>s of arbitrary timezones. The <tt class="docutils literal"><span class="pre"><span class="Identifier">times</span></span></tt> module only supplies implementations for the system's local time and UTC.
    985. 

  985.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L380" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    986. 

  986. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L380" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    987. 

  987. 

  988.   </dd>
    989. 

  989. </div>
    990. 

  990. <div id="WeekDay">
    991. 

  991.   <dt><pre><a href="times.html#WeekDay"><span class="Identifier">WeekDay</span></a> <span class="Other">=</span> <span class="Keyword">enum</span>
    992. 

  992.   <span class="Identifier">dMon</span> <span class="Other">=</span> <span class="StringLit">&quot;Monday&quot;</span><span class="Other">,</span> <span class="Identifier">dTue</span> <span class="Other">=</span> <span class="StringLit">&quot;Tuesday&quot;</span><span class="Other">,</span> <span class="Identifier">dWed</span> <span class="Other">=</span> <span class="StringLit">&quot;Wednesday&quot;</span><span class="Other">,</span> <span class="Identifier">dThu</span> <span class="Other">=</span> <span class="StringLit">&quot;Thursday&quot;</span><span class="Other">,</span>
    993. 

  993.   <span class="Identifier">dFri</span> <span class="Other">=</span> <span class="StringLit">&quot;Friday&quot;</span><span class="Other">,</span> <span class="Identifier">dSat</span> <span class="Other">=</span> <span class="StringLit">&quot;Saturday&quot;</span><span class="Other">,</span> <span class="Identifier">dSun</span> <span class="Other">=</span> <span class="StringLit">&quot;Sunday&quot;</span></pre></dt>
    994. 

  994.   <dd>
    995. 

  995.     
    996. 

  996.     Represents a weekday.
    997. 

  997.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L286" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    998. 

  998. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L286" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    999. 

  999. 

  1000.   </dd>
    1001. 

  1001. </div>
    1002. 

  1002. <div id="YeardayRange">
    1003. 

  1003.   <dt><pre><a href="times.html#YeardayRange"><span class="Identifier">YeardayRange</span></a> <span class="Other">=</span> <a href="system.html#range"><span class="Identifier">range</span></a><span class="Other">[</span><span class="DecNumber">0</span> <span class="Operator">..</span> <span class="DecNumber">365</span><span class="Other">]</span></pre></dt>
    1004. 

  1004.   <dd>
    1005. 

  1005.     
    1006. 

  1006.     
    1007. 

  1007.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L302" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1008. 

  1008. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L302" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1009. 

  1009. 

  1010.   </dd>
    1011. 

  1011. </div>
    1012. 

  1012. <div id="ZonedTime">
    1013. 

  1013.   <dt><pre><a href="times.html#ZonedTime"><span class="Identifier">ZonedTime</span></a> <span class="Other">=</span> <span class="Keyword">object</span>
    1014. 

  1014.   <span class="Identifier">time</span><span class="Operator">*</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a>                <span class="Comment">## The point in time being represented.</span>
    1015. 

  1015.   <span class="Identifier">utcOffset</span><span class="Operator">*</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a>            <span class="Comment">## The offset in seconds west of UTC,</span>
    1016. 

  1016.                              <span class="Comment">## including any offset due to DST.</span>
    1017. 

  1017.   <span class="Identifier">isDst</span><span class="Operator">*</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a>               <span class="Comment">## Determines whether DST is in effect.</span></pre></dt>
    1018. 

  1018.   <dd>
    1019. 

  1019.     
    1020. 

  1020.     Represents a point in time with an associated UTC offset and DST flag. This type is only used for implementing timezones.
    1021. 

  1021.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L390" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1022. 

  1022. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L390" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1023. 

  1023. 

  1024.   </dd>
    1025. 

  1025. </div>
    1026. 

  1026. 

  1027.   </dl>
    1028. 

  1028. </div>
    1029. 

  1029. <div class="section" id="10">
    1030. 

  1030.   <h1><a class="toc-backref" href="#10">Consts</a></h1>
    1031. 

  1031.   <dl class="item">
    1032. 

  1032.     <div id="DefaultLocale">
    1033. 

  1033.   <dt><pre><a href="times.html#DefaultLocale"><span class="Identifier">DefaultLocale</span></a> <span class="Other">=</span> <span class="Other">(</span><span class="Identifier">MMM</span><span class="Other">:</span> <span class="Other">[</span><span class="StringLit">&quot;Jan&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;Feb&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;Mar&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;Apr&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;May&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;Jun&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;Jul&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;Aug&quot;</span><span class="Other">,</span>
    1034. 

  1034.                        <span class="StringLit">&quot;Sep&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;Oct&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;Nov&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;Dec&quot;</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">MMMM</span><span class="Other">:</span> <span class="Other">[</span><span class="StringLit">&quot;January&quot;</span><span class="Other">,</span>
    1035. 

  1035.     <span class="StringLit">&quot;February&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;March&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;April&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;May&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;June&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;July&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;August&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;September&quot;</span><span class="Other">,</span>
    1036. 

  1036.     <span class="StringLit">&quot;October&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;November&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;December&quot;</span><span class="Other">]</span><span class="Other">,</span>
    1037. 

  1037.                  <span class="Identifier">ddd</span><span class="Other">:</span> <span class="Other">[</span><span class="StringLit">&quot;Mon&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;Tue&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;Wed&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;Thu&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;Fri&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;Sat&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;Sun&quot;</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">dddd</span><span class="Other">:</span> <span class="Other">[</span>
    1038. 

  1038.     <span class="StringLit">&quot;Monday&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;Tuesday&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;Wednesday&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;Thursday&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;Friday&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;Saturday&quot;</span><span class="Other">,</span> <span class="StringLit">&quot;Sunday&quot;</span><span class="Other">]</span><span class="Other">)</span></pre></dt>
    1039. 

  1039.   <dd>
    1040. 

  1040.     
    1041. 

  1041.     
    1042. 

  1042.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1626" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1043. 

  1043. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1626" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1044. 

  1044. 

  1045.   </dd>
    1046. 

  1046. </div>
    1047. 

  1047. <div id="DurationZero">
    1048. 

  1048.   <dt><pre><a href="times.html#DurationZero"><span class="Identifier">DurationZero</span></a> <span class="Other">=</span> <span class="Other">(</span><span class="Identifier">seconds</span><span class="Other">:</span> <span class="DecNumber">0</span><span class="Other">,</span> <span class="Identifier">nanosecond</span><span class="Other">:</span> <span class="DecNumber">0</span><span class="Other">)</span></pre></dt>
    1049. 

  1049.   <dd>
    1050. 

  1050.     
    1051. 

  1051.     <p>
    1052. 

  1052. Zero value for durations. Useful for comparisons.</p>
    1053. 

  1053. <p><pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">)</span> <span class="Operator">&gt;</span> <span class="Identifier">DurationZero</span>
    1054. 

  1054. <span class="Identifier">doAssert</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="DecNumber">0</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">DurationZero</span></pre></p>
    1055. 

  1055. 

  1056.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L658" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1057. 

  1057. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L658" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1058. 

  1058. 

  1059.   </dd>
    1060. 

  1060. </div>
    1061. 

  1061. 

  1062.   </dl>
    1063. 

  1063. </div>
    1064. 

  1064. <div class="section" id="12">
    1065. 

  1065.   <h1><a class="toc-backref" href="#12">Procs</a></h1>
    1066. 

  1066.   <dl class="item">
    1067. 

  1067.     <div id="$-procs-all">
    1068. 

  1068.   <div id="$,DateTime">
    1069. 

  1069.   <dt><pre><span class="Keyword">proc</span> <a href="#%24%2CDateTime"><span class="Identifier">`$`</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1070. 

  1070.   <dd>
    1071. 

  1071.     
    1072. 

  1072.     Converts a <tt class="docutils literal"><span class="pre"><span class="Identifier">DateTime</span></span></tt> object to a string representation. It uses the format <tt class="docutils literal"><span class="pre"><span class="Identifier">yyyy</span><span class="Operator">-</span><span class="Identifier">MM</span><span class="Operator">-</span><span class="Identifier">dd</span><span class="CharLit">'T'</span><span class="Identifier">HH</span><span class="Punctuation">:</span><span class="Identifier">mm</span><span class="Punctuation">:</span><span class="Identifier">sszzz</span></span></tt>.
    1073. 

  1073. <p><strong class="examples_text">Example:</strong></p>
    1074. 

  1074. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">dt</span> <span class="Operator">=</span> <span class="Identifier">dateTime</span><span class="Punctuation">(</span><span class="DecNumber">2000</span><span class="Punctuation">,</span> <span class="Identifier">mJan</span><span class="Punctuation">,</span> <span class="DecNumber">01</span><span class="Punctuation">,</span> <span class="DecNumber">12</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
    1075. 

  1075. <span class="Identifier">doAssert</span> <span class="Operator">$</span><span class="Identifier">dt</span> <span class="Operator">==</span> <span class="StringLit">&quot;2000-01-01T12:00:00Z&quot;</span>
    1076. 

  1076. <span class="Identifier">doAssert</span> <span class="Operator">$</span><span class="Identifier">default</span><span class="Punctuation">(</span><span class="Identifier">DateTime</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;Uninitialized DateTime&quot;</span></pre>
    1077. 

  1077.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2331" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1078. 

  1078. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2331" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1079. 

  1079. 

  1080.   </dd>
    1081. 

  1081. </div>
    1082. 

  1082. <div id="$,Duration">
    1083. 

  1083.   <dt><pre><span class="Keyword">proc</span> <a href="#%24%2CDuration"><span class="Identifier">`$`</span></a><span class="Other">(</span><span class="Identifier">dur</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1084. 

  1084.   <dd>
    1085. 

  1085.     
    1086. 

  1086.     Human friendly string representation of a <tt class="docutils literal"><span class="pre"><span class="Identifier">Duration</span></span></tt>.
    1087. 

  1087. <p><strong class="examples_text">Example:</strong></p>
    1088. 

  1088. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Operator">$</span><span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="DecNumber">2</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;2 seconds&quot;</span>
    1089. 

  1089. <span class="Identifier">doAssert</span> <span class="Operator">$</span><span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">weeks</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">,</span> <span class="Identifier">days</span> <span class="Operator">=</span> <span class="DecNumber">2</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;1 week and 2 days&quot;</span>
    1090. 

  1090. <span class="Identifier">doAssert</span> <span class="Operator">$</span><span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">hours</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">,</span> <span class="Identifier">minutes</span> <span class="Operator">=</span> <span class="DecNumber">2</span><span class="Punctuation">,</span> <span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="DecNumber">3</span><span class="Punctuation">)</span> <span class="Operator">==</span>
    1091. 

  1091.   <span class="StringLit">&quot;1 hour, 2 minutes, and 3 seconds&quot;</span>
    1092. 

  1092. <span class="Identifier">doAssert</span> <span class="Operator">$</span><span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">milliseconds</span> <span class="Operator">=</span> <span class="Operator">-</span><span class="DecNumber">1500</span><span class="Punctuation">)</span> <span class="Operator">==</span>
    1093. 

  1093.   <span class="StringLit">&quot;-1 second and -500 milliseconds&quot;</span></pre>
    1094. 

  1094.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L797" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1095. 

  1095. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L797" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1096. 

  1096. 

  1097.   </dd>
    1098. 

  1098. </div>
    1099. 

  1099. <div id="$,TimeFormat">
    1100. 

  1100.   <dt><pre><span class="Keyword">proc</span> <a href="#%24%2CTimeFormat"><span class="Identifier">`$`</span></a><span class="Other">(</span><span class="Identifier">f</span><span class="Other">:</span> <a href="times.html#TimeFormat"><span class="Identifier">TimeFormat</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1101. 

  1101.   <dd>
    1102. 

  1102.     
    1103. 

  1103.     Returns the format string that was used to construct <tt class="docutils literal"><span class="pre"><span class="Identifier">f</span></span></tt>.
    1104. 

  1104. <p><strong class="examples_text">Example:</strong></p>
    1105. 

  1105. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">f</span> <span class="Operator">=</span> <span class="Identifier">initTimeFormat</span><span class="Punctuation">(</span><span class="StringLit">&quot;yyyy-MM-dd&quot;</span><span class="Punctuation">)</span>
    1106. 

  1106. <span class="Identifier">doAssert</span> <span class="Operator">$</span><span class="Identifier">f</span> <span class="Operator">==</span> <span class="StringLit">&quot;yyyy-MM-dd&quot;</span></pre>
    1107. 

  1107.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1638" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1108. 

  1108. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1638" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1109. 

  1109. 

  1110.   </dd>
    1111. 

  1111. </div>
    1112. 

  1112. <div id="$,IsoYear">
    1113. 

  1113.   <dt><pre><span class="Keyword">proc</span> <a href="#%24%2CIsoYear"><span class="Identifier">`$`</span></a><span class="Other">(</span><span class="Identifier">p</span><span class="Other">:</span> <a href="times.html#IsoYear"><span class="Identifier">IsoYear</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span class="Identifier">borrow</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1114. 

  1114.   <dd>
    1115. 

  1115.     
    1116. 

  1116.     
    1117. 

  1117.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L565" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1118. 

  1118. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L565" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1119. 

  1119. 

  1120.   </dd>
    1121. 

  1121. </div>
    1122. 

  1122. <div id="$,TimeInterval">
    1123. 

  1123.   <dt><pre><span class="Keyword">proc</span> <a href="#%24%2CTimeInterval"><span class="Identifier">`$`</span></a><span class="Other">(</span><span class="Identifier">ti</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1124. 

  1124.   <dd>
    1125. 

  1125.     
    1126. 

  1126.     Get string representation of <tt class="docutils literal"><span class="pre"><span class="Identifier">TimeInterval</span></span></tt>.
    1127. 

  1127. <p><strong class="examples_text">Example:</strong></p>
    1128. 

  1128. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Operator">$</span><span class="Identifier">initTimeInterval</span><span class="Punctuation">(</span><span class="Identifier">years</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">,</span> <span class="Identifier">nanoseconds</span> <span class="Operator">=</span> <span class="DecNumber">123</span><span class="Punctuation">)</span> <span class="Operator">==</span>
    1129. 

  1129.   <span class="StringLit">&quot;1 year and 123 nanoseconds&quot;</span>
    1130. 

  1130. <span class="Identifier">doAssert</span> <span class="Operator">$</span><span class="Identifier">initTimeInterval</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;0 nanoseconds&quot;</span></pre>
    1131. 

  1131.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2571" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1132. 

  1132. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2571" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1133. 

  1133. 

  1134.   </dd>
    1135. 

  1135. </div>
    1136. 

  1136. <div id="$,Time">
    1137. 

  1137.   <dt><pre><span class="Keyword">proc</span> <a href="#%24%2CTime"><span class="Identifier">`$`</span></a><span class="Other">(</span><span class="Identifier">time</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1138. 

  1138.   <dd>
    1139. 

  1139.     
    1140. 

  1140.     Converts a <tt class="docutils literal"><span class="pre"><span class="Identifier">Time</span></span></tt> value to a string representation. It will use the local time zone and use the format <tt class="docutils literal"><span class="pre"><span class="Identifier">yyyy</span><span class="Operator">-</span><span class="Identifier">MM</span><span class="Operator">-</span><span class="Identifier">dd</span><span class="CharLit">'T'</span><span class="Identifier">HH</span><span class="Punctuation">:</span><span class="Identifier">mm</span><span class="Punctuation">:</span><span class="Identifier">sszzz</span></span></tt>.
    1141. 

  1141. <p><strong class="examples_text">Example:</strong></p>
    1142. 

  1142. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">dt</span> <span class="Operator">=</span> <span class="Identifier">dateTime</span><span class="Punctuation">(</span><span class="DecNumber">1970</span><span class="Punctuation">,</span> <span class="Identifier">mJan</span><span class="Punctuation">,</span> <span class="DecNumber">01</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="Identifier">local</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
    1143. 

  1143. <span class="Keyword">let</span> <span class="Identifier">tm</span> <span class="Operator">=</span> <span class="Identifier">dt</span><span class="Operator">.</span><span class="Identifier">toTime</span><span class="Punctuation">(</span><span class="Punctuation">)</span>
    1144. 

  1144. <span class="Identifier">doAssert</span> <span class="Operator">$</span><span class="Identifier">tm</span> <span class="Operator">==</span> <span class="StringLit">&quot;1970-01-01T00:00:00&quot;</span> <span class="Operator">&amp;</span> <span class="Identifier">format</span><span class="Punctuation">(</span><span class="Identifier">dt</span><span class="Punctuation">,</span> <span class="StringLit">&quot;zzz&quot;</span><span class="Punctuation">)</span></pre>
    1145. 

  1145.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2343" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1146. 

  1146. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2343" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1147. 

  1147. 

  1148.   </dd>
    1149. 

  1149. </div>
    1150. 

  1150. <div id="$,Timezone">
    1151. 

  1151.   <dt><pre><span class="Keyword">proc</span> <a href="#%24%2CTimezone"><span class="Identifier">`$`</span></a><span class="Other">(</span><span class="Identifier">zone</span><span class="Other">:</span> <a href="times.html#Timezone"><span class="Identifier">Timezone</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1152. 

  1152.   <dd>
    1153. 

  1153.     
    1154. 

  1154.     Returns the name of the timezone.
    1155. 

  1155.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1249" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1156. 

  1156. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1249" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1157. 

  1157. 

  1158.   </dd>
    1159. 

  1159. </div>
    1160. 

  1160. 

  1161. </div>
    1162. 

  1162. <div id="*-procs-all">
    1163. 

  1163.   <div id="*,Duration,int64">
    1164. 

  1164.   <dt><pre><span class="Keyword">proc</span> <a href="#%2A%2CDuration%2Cint64"><span class="Identifier">`*`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">;</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="system.html#int64"><span class="Identifier">int64</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> </span><span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1165. 

  1165.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;ntMulDuration&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1166. 

  1166.   <dd>
    1167. 

  1167.     
    1168. 

  1168.     Multiply a duration by some scalar.
    1169. 

  1169. <p><strong class="examples_text">Example:</strong></p>
    1170. 

  1170. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">)</span> <span class="Operator">*</span> <span class="DecNumber">5</span> <span class="Operator">==</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="DecNumber">5</span><span class="Punctuation">)</span>
    1171. 

  1171. <span class="Identifier">doAssert</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">minutes</span> <span class="Operator">=</span> <span class="DecNumber">45</span><span class="Punctuation">)</span> <span class="Operator">*</span> <span class="DecNumber">3</span> <span class="Operator">==</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">hours</span> <span class="Operator">=</span> <span class="DecNumber">2</span><span class="Punctuation">,</span> <span class="Identifier">minutes</span> <span class="Operator">=</span> <span class="DecNumber">15</span><span class="Punctuation">)</span></pre>
    1172. 

  1172.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L867" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1173. 

  1173. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L867" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1174. 

  1174. 

  1175.   </dd>
    1176. 

  1176. </div>
    1177. 

  1177. <div id="*,int64,Duration">
    1178. 

  1178.   <dt><pre><span class="Keyword">proc</span> <a href="#%2A%2Cint64%2CDuration"><span class="Identifier">`*`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <a href="system.html#int64"><span class="Identifier">int64</span></a><span class="Other">;</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> </span><span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1179. 

  1179.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;ntMulInt64Duration&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1180. 

  1180.   <dd>
    1181. 

  1181.     
    1182. 

  1182.     Multiply a duration by some scalar.
    1183. 

  1183. <p><strong class="examples_text">Example:</strong></p>
    1184. 

  1184. <pre class="listing"><span class="Identifier">doAssert</span> <span class="DecNumber">5</span> <span class="Operator">*</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="DecNumber">5</span><span class="Punctuation">)</span>
    1185. 

  1185. <span class="Identifier">doAssert</span> <span class="DecNumber">3</span> <span class="Operator">*</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">minutes</span> <span class="Operator">=</span> <span class="DecNumber">45</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">hours</span> <span class="Operator">=</span> <span class="DecNumber">2</span><span class="Punctuation">,</span> <span class="Identifier">minutes</span> <span class="Operator">=</span> <span class="DecNumber">15</span><span class="Punctuation">)</span></pre>
    1186. 

  1186.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L859" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1187. 

  1187. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L859" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1188. 

  1188. 

  1189.   </dd>
    1190. 

  1190. </div>
    1191. 

  1191. 

  1192. </div>
    1193. 

  1193. <div id="*=-procs-all">
    1194. 

  1194.   <div id="*=,Duration,int">
    1195. 

  1195.   <dt><pre><span class="Keyword">proc</span> <a href="#%2A%3D%2CDuration%2Cint"><span class="Identifier">`*=`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">;</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1196. 

  1196.   <dd>
    1197. 

  1197.     
    1198. 

  1198.     
    1199. 

  1199.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L881" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1200. 

  1200. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L881" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1201. 

  1201. 

  1202.   </dd>
    1203. 

  1203. </div>
    1204. 

  1204. 

  1205. </div>
    1206. 

  1206. <div id="+-procs-all">
    1207. 

  1207.   <div id="+,Duration,Duration">
    1208. 

  1208.   <dt><pre><span class="Keyword">proc</span> <a href="#%2B%2CDuration%2CDuration"><span class="Identifier">`+`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">,</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> </span><span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1209. 

  1209.                                      <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;ntAddDuration&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1210. 

  1210.                                      <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1211. 

  1211.   <dd>
    1212. 

  1212.     
    1213. 

  1213.     Add two durations together.
    1214. 

  1214. <p><strong class="examples_text">Example:</strong></p>
    1215. 

  1215. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">)</span> <span class="Operator">+</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">days</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">)</span> <span class="Operator">==</span>
    1216. 

  1216.   <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">,</span> <span class="Identifier">days</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">)</span></pre>
    1217. 

  1217.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L816" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1218. 

  1218. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L816" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1219. 

  1219. 

  1220.   </dd>
    1221. 

  1221. </div>
    1222. 

  1222. <div id="+,Time,Duration">
    1223. 

  1223.   <dt><pre><span class="Keyword">proc</span> <a href="#%2B%2CTime%2CDuration"><span class="Identifier">`+`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">;</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> </span><span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1224. 

  1224.                                        <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;ntAddTime&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1225. 

  1225.                                        <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1226. 

  1226.   <dd>
    1227. 

  1227.     
    1228. 

  1228.     Add a duration of time to a <tt class="docutils literal"><span class="pre"><span class="Identifier">Time</span></span></tt>.
    1229. 

  1229. <p><strong class="examples_text">Example:</strong></p>
    1230. 

  1230. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Punctuation">(</span><span class="Identifier">fromUnix</span><span class="Punctuation">(</span><span class="DecNumber">0</span><span class="Punctuation">)</span> <span class="Operator">+</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">)</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">fromUnix</span><span class="Punctuation">(</span><span class="DecNumber">1</span><span class="Punctuation">)</span></pre>
    1231. 

  1231.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1010" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1232. 

  1232. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1010" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1233. 

  1233. 

  1234.   </dd>
    1235. 

  1235. </div>
    1236. 

  1236. <div id="+,DateTime,Duration">
    1237. 

  1237.   <dt><pre><span class="Keyword">proc</span> <a href="#%2B%2CDateTime%2CDuration"><span class="Identifier">`+`</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">;</span> <span class="Identifier">dur</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1238. 

  1238.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1239. 

  1239.   <dd>
    1240. 

  1240.     
    1241. 

  1241.     
    1242. 

  1242. <p><strong class="examples_text">Example:</strong></p>
    1243. 

  1243. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">dt</span> <span class="Operator">=</span> <span class="Identifier">dateTime</span><span class="Punctuation">(</span><span class="DecNumber">2017</span><span class="Punctuation">,</span> <span class="Identifier">mMar</span><span class="Punctuation">,</span> <span class="DecNumber">30</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
    1244. 

  1244. <span class="Keyword">let</span> <span class="Identifier">dur</span> <span class="Operator">=</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">hours</span> <span class="Operator">=</span> <span class="DecNumber">5</span><span class="Punctuation">)</span>
    1245. 

  1245. <span class="Identifier">doAssert</span> <span class="Operator">$</span><span class="Punctuation">(</span><span class="Identifier">dt</span> <span class="Operator">+</span> <span class="Identifier">dur</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;2017-03-30T05:00:00Z&quot;</span></pre>
    1246. 

  1246.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1456" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1247. 

  1247. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1456" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1248. 

  1248. 

  1249.   </dd>
    1250. 

  1250. </div>
    1251. 

  1251. <div id="+,DateTime,TimeInterval">
    1252. 

  1252.   <dt><pre><span class="Keyword">proc</span> <a href="#%2B%2CDateTime%2CTimeInterval"><span class="Identifier">`+`</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">;</span> <span class="Identifier">interval</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1253. 

  1253.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1254. 

  1254.   <dd>
    1255. 

  1255.     
    1256. 

  1256.     <p>Adds <tt class="docutils literal"><span class="pre"><span class="Identifier">interval</span></span></tt> to <tt class="docutils literal"><span class="pre"><span class="Identifier">dt</span></span></tt>. Components from <tt class="docutils literal"><span class="pre"><span class="Identifier">interval</span></span></tt> are added in the order of their size, i.e. first the <tt class="docutils literal"><span class="pre"><span class="Identifier">years</span></span></tt> component, then the <tt class="docutils literal"><span class="pre"><span class="Identifier">months</span></span></tt> component and so on. The returned <tt class="docutils literal"><span class="pre"><span class="Identifier">DateTime</span></span></tt> will have the same timezone as the input.</p>
    1257. 

  1257. <p>Note that when adding months, monthday overflow is allowed. This means that if the resulting month doesn't have enough days it, the month will be incremented and the monthday will be set to the number of days overflowed. So adding one month to <tt class="docutils literal"><span class="pre"><span class="DecNumber">31</span> <span class="Identifier">October</span></span></tt> will result in <tt class="docutils literal"><span class="pre"><span class="DecNumber">31</span> <span class="Identifier">November</span></span></tt>, which will overflow and result in <tt class="docutils literal"><span class="pre"><span class="DecNumber">1</span> <span class="Identifier">December</span></span></tt>.</p>
    1258. 

  1258. 

  1259. <p><strong class="examples_text">Example:</strong></p>
    1260. 

  1260. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">dt</span> <span class="Operator">=</span> <span class="Identifier">dateTime</span><span class="Punctuation">(</span><span class="DecNumber">2017</span><span class="Punctuation">,</span> <span class="Identifier">mMar</span><span class="Punctuation">,</span> <span class="DecNumber">30</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
    1261. 

  1261. <span class="Identifier">doAssert</span> <span class="Operator">$</span><span class="Punctuation">(</span><span class="Identifier">dt</span> <span class="Operator">+</span> <span class="FloatNumber">1.</span><span class="Identifier">months</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;2017-04-30T00:00:00Z&quot;</span>
    1262. 

  1262. <span class="Comment"># This is correct and happens due to monthday overflow.</span>
    1263. 

  1263. <span class="Identifier">doAssert</span> <span class="Operator">$</span><span class="Punctuation">(</span><span class="Identifier">dt</span> <span class="Operator">-</span> <span class="FloatNumber">1.</span><span class="Identifier">months</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;2017-03-02T00:00:00Z&quot;</span></pre>
    1264. 

  1264.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2681" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1265. 

  1265. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2681" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1266. 

  1266. 

  1267.   </dd>
    1268. 

  1268. </div>
    1269. 

  1269. <div id="+,TimeInterval,TimeInterval">
    1270. 

  1270.   <dt><pre><span class="Keyword">proc</span> <a href="#%2B%2CTimeInterval%2CTimeInterval"><span class="Identifier">`+`</span></a><span class="Other">(</span><span class="Identifier">ti1</span><span class="Other">,</span> <span class="Identifier">ti2</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1271. 

  1271.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1272. 

  1272.   <dd>
    1273. 

  1273.     
    1274. 

  1274.     Adds two <tt class="docutils literal"><span class="pre"><span class="Identifier">TimeInterval</span></span></tt> objects together.
    1275. 

  1275.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2385" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1276. 

  1276. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2385" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1277. 

  1277. 

  1278.   </dd>
    1279. 

  1279. </div>
    1280. 

  1280. <div id="+,Time,TimeInterval">
    1281. 

  1281.   <dt><pre><span class="Keyword">proc</span> <a href="#%2B%2CTime%2CTimeInterval"><span class="Identifier">`+`</span></a><span class="Other">(</span><span class="Identifier">time</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">;</span> <span class="Identifier">interval</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1282. 

  1282.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1283. 

  1283.   <dd>
    1284. 

  1284.     
    1285. 

  1285.     Adds <tt class="docutils literal"><span class="pre"><span class="Identifier">interval</span></span></tt> to <tt class="docutils literal"><span class="pre"><span class="Identifier">time</span></span></tt>. If <tt class="docutils literal"><span class="pre"><span class="Identifier">interval</span></span></tt> contains any years, months, weeks or days the operation is performed in the local timezone.
    1286. 

  1286. <p><strong class="examples_text">Example:</strong></p>
    1287. 

  1287. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">tm</span> <span class="Operator">=</span> <span class="Identifier">fromUnix</span><span class="Punctuation">(</span><span class="DecNumber">0</span><span class="Punctuation">)</span>
    1288. 

  1288. <span class="Identifier">doAssert</span> <span class="Identifier">tm</span> <span class="Operator">+</span> <span class="FloatNumber">5.</span><span class="Identifier">seconds</span> <span class="Operator">==</span> <span class="Identifier">fromUnix</span><span class="Punctuation">(</span><span class="DecNumber">5</span><span class="Punctuation">)</span></pre>
    1289. 

  1289.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2721" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1290. 

  1290. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2721" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1291. 

  1291. 

  1292.   </dd>
    1293. 

  1293. </div>
    1294. 

  1294. 

  1295. </div>
    1296. 

  1296. <div id="+=-procs-all">
    1297. 

  1297.   <div id="+=,DateTime,Duration">
    1298. 

  1298.   <dt><pre><span class="Keyword">proc</span> <a href="#%2B%3D%2CDateTime%2CDuration"><span class="Identifier">`+=`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">;</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1299. 

  1299.   <dd>
    1300. 

  1300.     
    1301. 

  1301.     
    1302. 

  1302.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1496" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1303. 

  1303. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1496" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1304. 

  1304. 

  1305.   </dd>
    1306. 

  1306. </div>
    1307. 

  1307. <div id="+=,DateTime,TimeInterval">
    1308. 

  1308.   <dt><pre><span class="Keyword">proc</span> <a href="#%2B%3D%2CDateTime%2CTimeInterval"><span class="Identifier">`+=`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">;</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1309. 

  1309.   <dd>
    1310. 

  1310.     
    1311. 

  1311.     
    1312. 

  1312.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2747" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1313. 

  1313. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2747" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1314. 

  1314. 

  1315.   </dd>
    1316. 

  1316. </div>
    1317. 

  1317. <div id="+=,TimeInterval,TimeInterval">
    1318. 

  1318.   <dt><pre><span class="Keyword">proc</span> <a href="#%2B%3D%2CTimeInterval%2CTimeInterval"><span class="Identifier">`+=`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a><span class="Other">;</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1319. 

  1319.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1320. 

  1320.   <dd>
    1321. 

  1321.     
    1322. 

  1322.     
    1323. 

  1323.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2430" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1324. 

  1324. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2430" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1325. 

  1325. 

  1326.   </dd>
    1327. 

  1327. </div>
    1328. 

  1328. <div id="+=,Duration,Duration">
    1329. 

  1329.   <dt><pre><span class="Keyword">proc</span> <a href="#%2B%3D%2CDuration%2CDuration"><span class="Identifier">`+=`</span></a><span class="Other">(</span><span class="Identifier">d1</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">;</span> <span class="Identifier">d2</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1330. 

  1330.   <dd>
    1331. 

  1331.     
    1332. 

  1332.     
    1333. 

  1333.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L875" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1334. 

  1334. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L875" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1335. 

  1335. 

  1336.   </dd>
    1337. 

  1337. </div>
    1338. 

  1338. <div id="+=,Time,Duration">
    1339. 

  1339.   <dt><pre><span class="Keyword">proc</span> <a href="#%2B%3D%2CTime%2CDuration"><span class="Identifier">`+=`</span></a><span class="Other">(</span><span class="Identifier">t</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">;</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1340. 

  1340.   <dd>
    1341. 

  1341.     
    1342. 

  1342.     
    1343. 

  1343.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1036" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1344. 

  1344. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1036" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1345. 

  1345. 

  1346.   </dd>
    1347. 

  1347. </div>
    1348. 

  1348. <div id="+=,Time,TimeInterval">
    1349. 

  1349.   <dt><pre><span class="Keyword">proc</span> <a href="#%2B%3D%2CTime%2CTimeInterval"><span class="Identifier">`+=`</span></a><span class="Other">(</span><span class="Identifier">t</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">;</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1350. 

  1350.   <dd>
    1351. 

  1351.     
    1352. 

  1352.     
    1353. 

  1353.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2753" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1354. 

  1354. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2753" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1355. 

  1355. 

  1356.   </dd>
    1357. 

  1357. </div>
    1358. 

  1358. 

  1359. </div>
    1360. 

  1360. <div id="--procs-all">
    1361. 

  1361.   <div id="-,Duration,Duration">
    1362. 

  1362.   <dt><pre><span class="Keyword">proc</span> <a href="#-%2CDuration%2CDuration"><span class="Identifier">`-`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">,</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> </span><span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1363. 

  1363.                                      <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;ntSubDuration&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1364. 

  1364.                                      <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1365. 

  1365.   <dd>
    1366. 

  1366.     
    1367. 

  1367.     Subtract a duration from another.
    1368. 

  1368. <p><strong class="examples_text">Example:</strong></p>
    1369. 

  1369. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">,</span> <span class="Identifier">days</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">)</span> <span class="Operator">-</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">)</span> <span class="Operator">==</span>
    1370. 

  1370.   <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">days</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">)</span></pre>
    1371. 

  1371.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L823" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1372. 

  1372. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L823" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1373. 

  1373. 

  1374.   </dd>
    1375. 

  1375. </div>
    1376. 

  1376. <div id="-,Time,Time">
    1377. 

  1377.   <dt><pre><span class="Keyword">proc</span> <a href="#-%2CTime%2CTime"><span class="Identifier">`-`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">,</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> </span><span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1378. 

  1378.                                  <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;ntDiffTime&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1379. 

  1379.                                  <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1380. 

  1380.   <dd>
    1381. 

  1381.     
    1382. 

  1382.     Computes the duration between two points in time.
    1383. 

  1383. <p><strong class="examples_text">Example:</strong></p>
    1384. 

  1384. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">initTime</span><span class="Punctuation">(</span><span class="DecNumber">1000</span><span class="Punctuation">,</span> <span class="DecNumber">100</span><span class="Punctuation">)</span> <span class="Operator">-</span> <span class="Identifier">initTime</span><span class="Punctuation">(</span><span class="DecNumber">500</span><span class="Punctuation">,</span> <span class="DecNumber">20</span><span class="Punctuation">)</span> <span class="Operator">==</span>
    1385. 

  1385.   <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">minutes</span> <span class="Operator">=</span> <span class="DecNumber">8</span><span class="Punctuation">,</span> <span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="DecNumber">20</span><span class="Punctuation">,</span> <span class="Identifier">nanoseconds</span> <span class="Operator">=</span> <span class="DecNumber">80</span><span class="Punctuation">)</span></pre>
    1386. 

  1386.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1003" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1387. 

  1387. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1003" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1388. 

  1388. 

  1389.   </dd>
    1390. 

  1390. </div>
    1391. 

  1391. <div id="-,Duration">
    1392. 

  1392.   <dt><pre><span class="Keyword">proc</span> <a href="#-%2CDuration"><span class="Identifier">`-`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> </span><span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1393. 

  1393.                                   <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;ntReverseDuration&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1394. 

  1394.                                   <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1395. 

  1395.   <dd>
    1396. 

  1396.     
    1397. 

  1397.     Reverse a duration.
    1398. 

  1398. <p><strong class="examples_text">Example:</strong></p>
    1399. 

  1399. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Operator">-</span><span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="Operator">-</span><span class="DecNumber">1</span><span class="Punctuation">)</span></pre>
    1400. 

  1400.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L830" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1401. 

  1401. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L830" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1402. 

  1402. 

  1403.   </dd>
    1404. 

  1404. </div>
    1405. 

  1405. <div id="-,Time,Duration">
    1406. 

  1406.   <dt><pre><span class="Keyword">proc</span> <a href="#-%2CTime%2CDuration"><span class="Identifier">`-`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">;</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> </span><span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1407. 

  1407.                                        <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;ntSubTime&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1408. 

  1408.                                        <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1409. 

  1409.   <dd>
    1410. 

  1410.     
    1411. 

  1411.     Subtracts a duration of time from a <tt class="docutils literal"><span class="pre"><span class="Identifier">Time</span></span></tt>.
    1412. 

  1412. <p><strong class="examples_text">Example:</strong></p>
    1413. 

  1413. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Punctuation">(</span><span class="Identifier">fromUnix</span><span class="Punctuation">(</span><span class="DecNumber">0</span><span class="Punctuation">)</span> <span class="Operator">-</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">)</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">fromUnix</span><span class="Punctuation">(</span><span class="Operator">-</span><span class="DecNumber">1</span><span class="Punctuation">)</span></pre>
    1414. 

  1414.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1016" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1415. 

  1415. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1016" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1416. 

  1416. 

  1417.   </dd>
    1418. 

  1418. </div>
    1419. 

  1419. <div id="-,DateTime,DateTime">
    1420. 

  1420.   <dt><pre><span class="Keyword">proc</span> <a href="#-%2CDateTime%2CDateTime"><span class="Identifier">`-`</span></a><span class="Other">(</span><span class="Identifier">dt1</span><span class="Other">,</span> <span class="Identifier">dt2</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1421. 

  1421.   <dd>
    1422. 

  1422.     
    1423. 

  1423.     Compute the duration between <tt class="docutils literal"><span class="pre"><span class="Identifier">dt1</span></span></tt> and <tt class="docutils literal"><span class="pre"><span class="Identifier">dt2</span></span></tt>.
    1424. 

  1424. <p><strong class="examples_text">Example:</strong></p>
    1425. 

  1425. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">dt1</span> <span class="Operator">=</span> <span class="Identifier">dateTime</span><span class="Punctuation">(</span><span class="DecNumber">2017</span><span class="Punctuation">,</span> <span class="Identifier">mMar</span><span class="Punctuation">,</span> <span class="DecNumber">30</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
    1426. 

  1426. <span class="Keyword">let</span> <span class="Identifier">dt2</span> <span class="Operator">=</span> <span class="Identifier">dateTime</span><span class="Punctuation">(</span><span class="DecNumber">2017</span><span class="Punctuation">,</span> <span class="Identifier">mMar</span><span class="Punctuation">,</span> <span class="DecNumber">25</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
    1427. 

  1427. 

  1428. <span class="Identifier">doAssert</span> <span class="Identifier">dt1</span> <span class="Operator">-</span> <span class="Identifier">dt2</span> <span class="Operator">==</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">days</span> <span class="Operator">=</span> <span class="DecNumber">5</span><span class="Punctuation">)</span></pre>
    1429. 

  1429.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1472" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1430. 

  1430. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1472" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1431. 

  1431. 

  1432.   </dd>
    1433. 

  1433. </div>
    1434. 

  1434. <div id="-,DateTime,Duration">
    1435. 

  1435.   <dt><pre><span class="Keyword">proc</span> <a href="#-%2CDateTime%2CDuration"><span class="Identifier">`-`</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">;</span> <span class="Identifier">dur</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1436. 

  1436.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1437. 

  1437.   <dd>
    1438. 

  1438.     
    1439. 

  1439.     
    1440. 

  1440. <p><strong class="examples_text">Example:</strong></p>
    1441. 

  1441. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">dt</span> <span class="Operator">=</span> <span class="Identifier">dateTime</span><span class="Punctuation">(</span><span class="DecNumber">2017</span><span class="Punctuation">,</span> <span class="Identifier">mMar</span><span class="Punctuation">,</span> <span class="DecNumber">30</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
    1442. 

  1442. <span class="Keyword">let</span> <span class="Identifier">dur</span> <span class="Operator">=</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">days</span> <span class="Operator">=</span> <span class="DecNumber">5</span><span class="Punctuation">)</span>
    1443. 

  1443. <span class="Identifier">doAssert</span> <span class="Operator">$</span><span class="Punctuation">(</span><span class="Identifier">dt</span> <span class="Operator">-</span> <span class="Identifier">dur</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;2017-03-25T00:00:00Z&quot;</span></pre>
    1444. 

  1444.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1464" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1445. 

  1445. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1464" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1446. 

  1446. 

  1447.   </dd>
    1448. 

  1448. </div>
    1449. 

  1449. <div id="-,DateTime,TimeInterval">
    1450. 

  1450.   <dt><pre><span class="Keyword">proc</span> <a href="#-%2CDateTime%2CTimeInterval"><span class="Identifier">`-`</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">;</span> <span class="Identifier">interval</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1451. 

  1451.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1452. 

  1452.   <dd>
    1453. 

  1453.     
    1454. 

  1454.     Subtract <tt class="docutils literal"><span class="pre"><span class="Identifier">interval</span></span></tt> from <tt class="docutils literal"><span class="pre"><span class="Identifier">dt</span></span></tt>. Components from <tt class="docutils literal"><span class="pre"><span class="Identifier">interval</span></span></tt> are subtracted in the order of their size, i.e. first the <tt class="docutils literal"><span class="pre"><span class="Identifier">years</span></span></tt> component, then the <tt class="docutils literal"><span class="pre"><span class="Identifier">months</span></span></tt> component and so on. The returned <tt class="docutils literal"><span class="pre"><span class="Identifier">DateTime</span></span></tt> will have the same timezone as the input.
    1455. 

  1455. <p><strong class="examples_text">Example:</strong></p>
    1456. 

  1456. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">dt</span> <span class="Operator">=</span> <span class="Identifier">dateTime</span><span class="Punctuation">(</span><span class="DecNumber">2017</span><span class="Punctuation">,</span> <span class="Identifier">mMar</span><span class="Punctuation">,</span> <span class="DecNumber">30</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
    1457. 

  1457. <span class="Identifier">doAssert</span> <span class="Operator">$</span><span class="Punctuation">(</span><span class="Identifier">dt</span> <span class="Operator">-</span> <span class="FloatNumber">5.</span><span class="Identifier">days</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;2017-03-25T00:00:00Z&quot;</span></pre>
    1458. 

  1458.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2710" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1459. 

  1459. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2710" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1460. 

  1460. 

  1461.   </dd>
    1462. 

  1462. </div>
    1463. 

  1463. <div id="-,TimeInterval,TimeInterval">
    1464. 

  1464.   <dt><pre><span class="Keyword">proc</span> <a href="#-%2CTimeInterval%2CTimeInterval"><span class="Identifier">`-`</span></a><span class="Other">(</span><span class="Identifier">ti1</span><span class="Other">,</span> <span class="Identifier">ti2</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1465. 

  1465.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1466. 

  1466.   <dd>
    1467. 

  1467.     
    1468. 

  1468.     <p>Subtracts TimeInterval <tt class="docutils literal"><span class="pre"><span class="Identifier">ti1</span></span></tt> from <tt class="docutils literal"><span class="pre"><span class="Identifier">ti2</span></span></tt>.</p>
    1469. 

  1469. <p>Time components are subtracted one-by-one, see output:</p>
    1470. 

  1470. 

  1471. <p><strong class="examples_text">Example:</strong></p>
    1472. 

  1472. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">ti1</span> <span class="Operator">=</span> <span class="Identifier">initTimeInterval</span><span class="Punctuation">(</span><span class="Identifier">hours</span> <span class="Operator">=</span> <span class="DecNumber">24</span><span class="Punctuation">)</span>
    1473. 

  1473. <span class="Keyword">let</span> <span class="Identifier">ti2</span> <span class="Operator">=</span> <span class="Identifier">initTimeInterval</span><span class="Punctuation">(</span><span class="Identifier">hours</span> <span class="Operator">=</span> <span class="DecNumber">4</span><span class="Punctuation">)</span>
    1474. 

  1474. <span class="Identifier">doAssert</span> <span class="Punctuation">(</span><span class="Identifier">ti1</span> <span class="Operator">-</span> <span class="Identifier">ti2</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">initTimeInterval</span><span class="Punctuation">(</span><span class="Identifier">hours</span> <span class="Operator">=</span> <span class="DecNumber">20</span><span class="Punctuation">)</span></pre>
    1475. 

  1475.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2419" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1476. 

  1476. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2419" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1477. 

  1477. 

  1478.   </dd>
    1479. 

  1479. </div>
    1480. 

  1480. <div id="-,TimeInterval">
    1481. 

  1481.   <dt><pre><span class="Keyword">proc</span> <a href="#-%2CTimeInterval"><span class="Identifier">`-`</span></a><span class="Other">(</span><span class="Identifier">ti</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1482. 

  1482.   <dd>
    1483. 

  1483.     
    1484. 

  1484.     Reverses a time interval
    1485. 

  1485. <p><strong class="examples_text">Example:</strong></p>
    1486. 

  1486. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">day</span> <span class="Operator">=</span> <span class="Operator">-</span><span class="Identifier">initTimeInterval</span><span class="Punctuation">(</span><span class="Identifier">hours</span> <span class="Operator">=</span> <span class="DecNumber">24</span><span class="Punctuation">)</span>
    1487. 

  1487. <span class="Identifier">doAssert</span> <span class="Identifier">day</span><span class="Operator">.</span><span class="Identifier">hours</span> <span class="Operator">==</span> <span class="Operator">-</span><span class="DecNumber">24</span></pre>
    1488. 

  1488.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2400" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1489. 

  1489. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2400" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1490. 

  1490. 

  1491.   </dd>
    1492. 

  1492. </div>
    1493. 

  1493. <div id="-,Time,TimeInterval">
    1494. 

  1494.   <dt><pre><span class="Keyword">proc</span> <a href="#-%2CTime%2CTimeInterval"><span class="Identifier">`-`</span></a><span class="Other">(</span><span class="Identifier">time</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">;</span> <span class="Identifier">interval</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1495. 

  1495.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1496. 

  1496.   <dd>
    1497. 

  1497.     
    1498. 

  1498.     Subtracts <tt class="docutils literal"><span class="pre"><span class="Identifier">interval</span></span></tt> from Time <tt class="docutils literal"><span class="pre"><span class="Identifier">time</span></span></tt>. If <tt class="docutils literal"><span class="pre"><span class="Identifier">interval</span></span></tt> contains any years, months, weeks or days the operation is performed in the local timezone.
    1499. 

  1499. <p><strong class="examples_text">Example:</strong></p>
    1500. 

  1500. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">tm</span> <span class="Operator">=</span> <span class="Identifier">fromUnix</span><span class="Punctuation">(</span><span class="DecNumber">5</span><span class="Punctuation">)</span>
    1501. 

  1501. <span class="Identifier">doAssert</span> <span class="Identifier">tm</span> <span class="Operator">-</span> <span class="FloatNumber">5.</span><span class="Identifier">seconds</span> <span class="Operator">==</span> <span class="Identifier">fromUnix</span><span class="Punctuation">(</span><span class="DecNumber">0</span><span class="Punctuation">)</span></pre>
    1502. 

  1502.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2734" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1503. 

  1503. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2734" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1504. 

  1504. 

  1505.   </dd>
    1506. 

  1506. </div>
    1507. 

  1507. 

  1508. </div>
    1509. 

  1509. <div id="-=-procs-all">
    1510. 

  1510.   <div id="-=,DateTime,Duration">
    1511. 

  1511.   <dt><pre><span class="Keyword">proc</span> <a href="#-%3D%2CDateTime%2CDuration"><span class="Identifier">`-=`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">;</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1512. 

  1512.   <dd>
    1513. 

  1513.     
    1514. 

  1514.     
    1515. 

  1515.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1499" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1516. 

  1516. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1499" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1517. 

  1517. 

  1518.   </dd>
    1519. 

  1519. </div>
    1520. 

  1520. <div id="-=,DateTime,TimeInterval">
    1521. 

  1521.   <dt><pre><span class="Keyword">proc</span> <a href="#-%3D%2CDateTime%2CTimeInterval"><span class="Identifier">`-=`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">;</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1522. 

  1522.   <dd>
    1523. 

  1523.     
    1524. 

  1524.     
    1525. 

  1525.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2750" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1526. 

  1526. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2750" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1527. 

  1527. 

  1528.   </dd>
    1529. 

  1529. </div>
    1530. 

  1530. <div id="-=,TimeInterval,TimeInterval">
    1531. 

  1531.   <dt><pre><span class="Keyword">proc</span> <a href="#-%3D%2CTimeInterval%2CTimeInterval"><span class="Identifier">`-=`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a><span class="Other">;</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1532. 

  1532.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1533. 

  1533.   <dd>
    1534. 

  1534.     
    1535. 

  1535.     
    1536. 

  1536.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2433" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1537. 

  1537. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2433" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1538. 

  1538. 

  1539.   </dd>
    1540. 

  1540. </div>
    1541. 

  1541. <div id="-=,Duration,Duration">
    1542. 

  1542.   <dt><pre><span class="Keyword">proc</span> <a href="#-%3D%2CDuration%2CDuration"><span class="Identifier">`-=`</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">;</span> <span class="Identifier">ti</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1543. 

  1543.   <dd>
    1544. 

  1544.     
    1545. 

  1545.     
    1546. 

  1546.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L878" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1547. 

  1547. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L878" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1548. 

  1548. 

  1549.   </dd>
    1550. 

  1550. </div>
    1551. 

  1551. <div id="-=,Time,Duration">
    1552. 

  1552.   <dt><pre><span class="Keyword">proc</span> <a href="#-%3D%2CTime%2CDuration"><span class="Identifier">`-=`</span></a><span class="Other">(</span><span class="Identifier">t</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">;</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1553. 

  1553.   <dd>
    1554. 

  1554.     
    1555. 

  1555.     
    1556. 

  1556.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1039" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1557. 

  1557. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1039" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1558. 

  1558. 

  1559.   </dd>
    1560. 

  1560. </div>
    1561. 

  1561. <div id="-=,Time,TimeInterval">
    1562. 

  1562.   <dt><pre><span class="Keyword">proc</span> <a href="#-%3D%2CTime%2CTimeInterval"><span class="Identifier">`-=`</span></a><span class="Other">(</span><span class="Identifier">t</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">;</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1563. 

  1563.   <dd>
    1564. 

  1564.     
    1565. 

  1565.     
    1566. 

  1566.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2756" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1567. 

  1567. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2756" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1568. 

  1568. 

  1569.   </dd>
    1570. 

  1570. </div>
    1571. 

  1571. 

  1572. </div>
    1573. 

  1573. <div id="&lt;-procs-all">
    1574. 

  1574.   <div id="<,DateTime,DateTime">
    1575. 

  1575.   <dt><pre><span class="Keyword">proc</span> <a href="#%3C%2CDateTime%2CDateTime"><span class="Identifier">`&lt;`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">,</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1576. 

  1576.   <dd>
    1577. 

  1577.     
    1578. 

  1578.     Returns true if <tt class="docutils literal"><span class="pre"><span class="Identifier">a</span></span></tt> happened before <tt class="docutils literal"><span class="pre"><span class="Identifier">b</span></span></tt>.
    1579. 

  1579.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1482" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1580. 

  1580. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1482" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1581. 

  1581. 

  1582.   </dd>
    1583. 

  1583. </div>
    1584. 

  1584. <div id="<,Duration,Duration">
    1585. 

  1585.   <dt><pre><span class="Keyword">proc</span> <a href="#%3C%2CDuration%2CDuration"><span class="Identifier">`&lt;`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">,</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> </span><span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1586. 

  1586.                                  <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;ntLtDuration&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1587. 

  1587.                                  <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1588. 

  1588.   <dd>
    1589. 

  1589.     
    1590. 

  1590.     Note that a duration can be negative, so even if <tt class="docutils literal"><span class="pre"><span class="Identifier">a</span> <span class="Operator">&lt;</span> <span class="Identifier">b</span></span></tt> is true <tt class="docutils literal"><span class="pre"><span class="Identifier">a</span></span></tt> might represent a larger absolute duration. Use <tt class="docutils literal"><span class="pre"><span class="Identifier">abs</span><span class="Punctuation">(</span><span class="Identifier">a</span><span class="Punctuation">)</span> <span class="Operator">&lt;</span> <span class="Identifier">abs</span><span class="Punctuation">(</span><span class="Identifier">b</span><span class="Punctuation">)</span></span></tt> to compare the absolute duration.
    1591. 

  1591. <p><strong class="examples_text">Example:</strong></p>
    1592. 

  1592. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">)</span> <span class="Operator">&lt;</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="DecNumber">2</span><span class="Punctuation">)</span>
    1593. 

  1593. <span class="Identifier">doAssert</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="Operator">-</span><span class="DecNumber">2</span><span class="Punctuation">)</span> <span class="Operator">&lt;</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">)</span>
    1594. 

  1594. <span class="Identifier">doAssert</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="Operator">-</span><span class="DecNumber">2</span><span class="Punctuation">)</span><span class="Operator">.</span><span class="Identifier">abs</span> <span class="Operator">&lt;</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">)</span><span class="Operator">.</span><span class="Identifier">abs</span> <span class="Operator">==</span> <span class="Identifier">false</span></pre>
    1595. 

  1595.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L836" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1596. 

  1596. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L836" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1597. 

  1597. 

  1598.   </dd>
    1599. 

  1599. </div>
    1600. 

  1600. <div id="<,Time,Time">
    1601. 

  1601.   <dt><pre><span class="Keyword">proc</span> <a href="#%3C%2CTime%2CTime"><span class="Identifier">`&lt;`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">,</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> </span><span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;ntLtTime&quot;</span><span class="Other">,</span>
    1602. 

  1602.                              <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1603. 

  1603.   <dd>
    1604. 

  1604.     
    1605. 

  1605.     Returns true if <tt class="docutils literal"><span class="pre"><span class="Identifier">a</span> <span class="Operator">&lt;</span> <span class="Identifier">b</span></span></tt>, that is if <tt class="docutils literal"><span class="pre"><span class="Identifier">a</span></span></tt> happened before <tt class="docutils literal"><span class="pre"><span class="Identifier">b</span></span></tt>.
    1606. 

  1606. <p><strong class="examples_text">Example:</strong></p>
    1607. 

  1607. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">initTime</span><span class="Punctuation">(</span><span class="DecNumber">50</span><span class="Punctuation">,</span> <span class="DecNumber">0</span><span class="Punctuation">)</span> <span class="Operator">&lt;</span> <span class="Identifier">initTime</span><span class="Punctuation">(</span><span class="DecNumber">99</span><span class="Punctuation">,</span> <span class="DecNumber">0</span><span class="Punctuation">)</span></pre>
    1608. 

  1608.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1022" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1609. 

  1609. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1022" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1610. 

  1610. 

  1611.   </dd>
    1612. 

  1612. </div>
    1613. 

  1613. 

  1614. </div>
    1615. 

  1615. <div id="&lt;=-procs-all">
    1616. 

  1616.   <div id="<=,DateTime,DateTime">
    1617. 

  1617.   <dt><pre><span class="Keyword">proc</span> <a href="#%3C%3D%2CDateTime%2CDateTime"><span class="Identifier">`&lt;=`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">,</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1618. 

  1618.   <dd>
    1619. 

  1619.     
    1620. 

  1620.     Returns true if <tt class="docutils literal"><span class="pre"><span class="Identifier">a</span></span></tt> happened before or at the same time as <tt class="docutils literal"><span class="pre"><span class="Identifier">b</span></span></tt>.
    1621. 

  1621.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1486" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1622. 

  1622. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1486" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1623. 

  1623. 

  1624.   </dd>
    1625. 

  1625. </div>
    1626. 

  1626. <div id="<=,Duration,Duration">
    1627. 

  1627.   <dt><pre><span class="Keyword">proc</span> <a href="#%3C%3D%2CDuration%2CDuration"><span class="Identifier">`&lt;=`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">,</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> </span><span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1628. 

  1628.                                   <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;ntLeDuration&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1629. 

  1629.                                   <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1630. 

  1630.   <dd>
    1631. 

  1631.     
    1632. 

  1632.     
    1633. 

  1633.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L848" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1634. 

  1634. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L848" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1635. 

  1635. 

  1636.   </dd>
    1637. 

  1637. </div>
    1638. 

  1638. <div id="<=,Time,Time">
    1639. 

  1639.   <dt><pre><span class="Keyword">proc</span> <a href="#%3C%3D%2CTime%2CTime"><span class="Identifier">`&lt;=`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">,</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> </span><span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;ntLeTime&quot;</span><span class="Other">,</span>
    1640. 

  1640.                               <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1641. 

  1641.   <dd>
    1642. 

  1642.     
    1643. 

  1643.     Returns true if <tt class="docutils literal"><span class="pre"><span class="Identifier">a</span> <span class="Operator">&lt;=</span> <span class="Identifier">b</span></span></tt>.
    1644. 

  1644.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1028" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1645. 

  1645. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1028" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1646. 

  1646. 

  1647.   </dd>
    1648. 

  1648. </div>
    1649. 

  1649. 

  1650. </div>
    1651. 

  1651. <div id="==-procs-all">
    1652. 

  1652.   <div id="==,DateTime,DateTime">
    1653. 

  1653.   <dt><pre><span class="Keyword">proc</span> <a href="#%3D%3D%2CDateTime%2CDateTime"><span class="Identifier">`==`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">,</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1654. 

  1654.   <dd>
    1655. 

  1655.     
    1656. 

  1656.     Returns true if <tt class="docutils literal"><span class="pre"><span class="Identifier">a</span></span></tt> and <tt class="docutils literal"><span class="pre"><span class="Identifier">b</span></span></tt> represent the same point in time.
    1657. 

  1657.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1490" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1658. 

  1658. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1490" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1659. 

  1659. 

  1660.   </dd>
    1661. 

  1661. </div>
    1662. 

  1662. <div id="==,Duration,Duration">
    1663. 

  1663.   <dt><pre><span class="Keyword">proc</span> <a href="#%3D%3D%2CDuration%2CDuration"><span class="Identifier">`==`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">,</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> </span><span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1664. 

  1664.                                   <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;ntEqDuration&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1665. 

  1665.                                   <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1666. 

  1666.   <dd>
    1667. 

  1667.     
    1668. 

  1668.     
    1669. 

  1669. <p><strong class="examples_text">Example:</strong></p>
    1670. 

  1670. <pre class="listing"><span class="Keyword">let</span>
    1671. 

  1671.   <span class="Identifier">d1</span> <span class="Operator">=</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">weeks</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">)</span>
    1672. 

  1672.   <span class="Identifier">d2</span> <span class="Operator">=</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">days</span> <span class="Operator">=</span> <span class="DecNumber">7</span><span class="Punctuation">)</span>
    1673. 

  1673. <span class="Identifier">doAssert</span> <span class="Identifier">d1</span> <span class="Operator">==</span> <span class="Identifier">d2</span></pre>
    1674. 

  1674.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L851" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1675. 

  1675. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L851" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1676. 

  1676. 

  1677.   </dd>
    1678. 

  1678. </div>
    1679. 

  1679. <div id="==,IsoYear,IsoYear">
    1680. 

  1680.   <dt><pre><span class="Keyword">proc</span> <a href="#%3D%3D%2CIsoYear%2CIsoYear"><span class="Identifier">`==`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">,</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="times.html#IsoYear"><span class="Identifier">IsoYear</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span class="Identifier">borrow</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1681. 

  1681.   <dd>
    1682. 

  1682.     
    1683. 

  1683.     
    1684. 

  1684.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L564" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1685. 

  1685. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L564" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1686. 

  1686. 

  1687.   </dd>
    1688. 

  1688. </div>
    1689. 

  1689. <div id="==,Time,Time">
    1690. 

  1690.   <dt><pre><span class="Keyword">proc</span> <a href="#%3D%3D%2CTime%2CTime"><span class="Identifier">`==`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">,</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> </span><span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;ntEqTime&quot;</span><span class="Other">,</span>
    1691. 

  1691.                               <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1692. 

  1692.   <dd>
    1693. 

  1693.     
    1694. 

  1694.     Returns true if <tt class="docutils literal"><span class="pre"><span class="Identifier">a</span> <span class="Operator">==</span> <span class="Identifier">b</span></span></tt>, that is if both times represent the same point in time.
    1695. 

  1695.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1032" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1696. 

  1696. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1032" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1697. 

  1697. 

  1698.   </dd>
    1699. 

  1699. </div>
    1700. 

  1700. <div id="==,Timezone,Timezone">
    1701. 

  1701.   <dt><pre><span class="Keyword">proc</span> <a href="#%3D%3D%2CTimezone%2CTimezone"><span class="Identifier">`==`</span></a><span class="Other">(</span><span class="Identifier">zone1</span><span class="Other">,</span> <span class="Identifier">zone2</span><span class="Other">:</span> <a href="times.html#Timezone"><span class="Identifier">Timezone</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1702. 

  1702.   <dd>
    1703. 

  1703.     
    1704. 

  1704.     Two <tt class="docutils literal"><span class="pre"><span class="Identifier">Timezone</span></span></tt>'s are considered equal if their name is equal.
    1705. 

  1705. <p><strong class="examples_text">Example:</strong></p>
    1706. 

  1706. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">local</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">local</span><span class="Punctuation">(</span><span class="Punctuation">)</span>
    1707. 

  1707. <span class="Identifier">doAssert</span> <span class="Identifier">local</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">!=</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span></pre>
    1708. 

  1708.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1254" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1709. 

  1709. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1254" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1710. 

  1710. 

  1711.   </dd>
    1712. 

  1712. </div>
    1713. 

  1713. 

  1714. </div>
    1715. 

  1715. <div id="abs-procs-all">
    1716. 

  1716.   <div id="abs,Duration">
    1717. 

  1717.   <dt><pre><span class="Keyword">proc</span> <a href="#abs%2CDuration"><span class="Identifier">abs</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1718. 

  1718.   <dd>
    1719. 

  1719.     
    1720. 

  1720.     
    1721. 

  1721. <p><strong class="examples_text">Example:</strong></p>
    1722. 

  1722. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">milliseconds</span> <span class="Operator">=</span> <span class="Operator">-</span><span class="DecNumber">1500</span><span class="Punctuation">)</span><span class="Operator">.</span><span class="Identifier">abs</span> <span class="Operator">==</span>
    1723. 

  1723.   <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">milliseconds</span> <span class="Operator">=</span> <span class="DecNumber">1500</span><span class="Punctuation">)</span></pre>
    1724. 

  1724.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L905" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1725. 

  1725. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L905" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1726. 

  1726. 

  1727.   </dd>
    1728. 

  1728. </div>
    1729. 

  1729. 

  1730. </div>
    1731. 

  1731. <div id="between-procs-all">
    1732. 

  1732.   <div id="between,DateTime,DateTime">
    1733. 

  1733.   <dt><pre><span class="Keyword">proc</span> <a href="#between%2CDateTime%2CDateTime"><span class="Identifier">between</span></a><span class="Other">(</span><span class="Identifier">startDt</span><span class="Other">,</span> <span class="Identifier">endDt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1734. 

  1734.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1735. 

  1735.   <dd>
    1736. 

  1736.     
    1737. 

  1737.     Gives the difference between <tt class="docutils literal"><span class="pre"><span class="Identifier">startDt</span></span></tt> and <tt class="docutils literal"><span class="pre"><span class="Identifier">endDt</span></span></tt> as a <tt class="docutils literal"><span class="pre"><span class="Identifier">TimeInterval</span></span></tt>. The following guarantees about the result is given:<ul class="simple"><li>All fields will have the same sign.</li>
    1738. 

  1738. <li>If <tt class="docutils literal"><span class="pre"><span class="Identifier">startDt</span><span class="Operator">.</span><span class="Identifier">timezone</span> <span class="Operator">==</span> <span class="Identifier">endDt</span><span class="Operator">.</span><span class="Identifier">timezone</span></span></tt>, it is guaranteed that <tt class="docutils literal"><span class="pre"><span class="Identifier">startDt</span> <span class="Operator">+</span> <span class="Identifier">between</span><span class="Punctuation">(</span><span class="Identifier">startDt</span><span class="Punctuation">,</span> <span class="Identifier">endDt</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">endDt</span></span></tt>.</li>
    1739. 

  1739. <li>If <tt class="docutils literal"><span class="pre"><span class="Identifier">startDt</span><span class="Operator">.</span><span class="Identifier">timezone</span> <span class="Operator">!=</span> <span class="Identifier">endDt</span><span class="Operator">.</span><span class="Identifier">timezone</span></span></tt>, then the result will be equivalent to <tt class="docutils literal"><span class="pre"><span class="Identifier">between</span><span class="Punctuation">(</span><span class="Identifier">startDt</span><span class="Operator">.</span><span class="Identifier">utc</span><span class="Punctuation">,</span> <span class="Identifier">endDt</span><span class="Operator">.</span><span class="Identifier">utc</span><span class="Punctuation">)</span></span></tt>.</li>
    1740. 

  1740. </ul>
    1741. 

  1741. 

  1742. <p><strong class="examples_text">Example:</strong></p>
    1743. 

  1743. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">a</span> <span class="Operator">=</span> <span class="Identifier">dateTime</span><span class="Punctuation">(</span><span class="DecNumber">2015</span><span class="Punctuation">,</span> <span class="Identifier">mMar</span><span class="Punctuation">,</span> <span class="DecNumber">25</span><span class="Punctuation">,</span> <span class="DecNumber">12</span><span class="Punctuation">,</span> <span class="DecNumber">0</span><span class="Punctuation">,</span> <span class="DecNumber">0</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
    1744. 

  1744. <span class="Keyword">var</span> <span class="Identifier">b</span> <span class="Operator">=</span> <span class="Identifier">dateTime</span><span class="Punctuation">(</span><span class="DecNumber">2017</span><span class="Punctuation">,</span> <span class="Identifier">mApr</span><span class="Punctuation">,</span> <span class="DecNumber">1</span><span class="Punctuation">,</span> <span class="DecNumber">15</span><span class="Punctuation">,</span> <span class="DecNumber">0</span><span class="Punctuation">,</span> <span class="DecNumber">15</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
    1745. 

  1745. <span class="Keyword">var</span> <span class="Identifier">ti</span> <span class="Operator">=</span> <span class="Identifier">initTimeInterval</span><span class="Punctuation">(</span><span class="Identifier">years</span> <span class="Operator">=</span> <span class="DecNumber">2</span><span class="Punctuation">,</span> <span class="Identifier">weeks</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">,</span> <span class="Identifier">hours</span> <span class="Operator">=</span> <span class="DecNumber">3</span><span class="Punctuation">,</span> <span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="DecNumber">15</span><span class="Punctuation">)</span>
    1746. 

  1746. <span class="Identifier">doAssert</span> <span class="Identifier">between</span><span class="Punctuation">(</span><span class="Identifier">a</span><span class="Punctuation">,</span> <span class="Identifier">b</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">ti</span>
    1747. 

  1747. <span class="Identifier">doAssert</span> <span class="Identifier">between</span><span class="Punctuation">(</span><span class="Identifier">a</span><span class="Punctuation">,</span> <span class="Identifier">b</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Operator">-</span><span class="Identifier">between</span><span class="Punctuation">(</span><span class="Identifier">b</span><span class="Punctuation">,</span> <span class="Identifier">a</span><span class="Punctuation">)</span></pre>
    1748. 

  1748.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2449" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1749. 

  1749. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2449" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1750. 

  1750. 

  1751.   </dd>
    1752. 

  1752. </div>
    1753. 

  1753. 

  1754. </div>
    1755. 

  1755. <div id="convert-procs-all">
    1756. 

  1756.   <div id="convert,FixedTimeUnit,FixedTimeUnit,T">
    1757. 

  1757.   <dt><pre><span class="Keyword">proc</span> <a href="#convert%2CFixedTimeUnit%2CFixedTimeUnit%2CT"><span class="Identifier">convert</span></a><span class="Other">[</span><span class="Identifier">T</span><span class="Other">:</span> <a href="system.html#SomeInteger"><span class="Identifier">SomeInteger</span></a><span class="Other">]</span><span class="Other">(</span><span class="Identifier">unitFrom</span><span class="Other">,</span> <span class="Identifier">unitTo</span><span class="Other">:</span> <a href="times.html#FixedTimeUnit"><span class="Identifier">FixedTimeUnit</span></a><span class="Other">;</span> <span class="Identifier">quantity</span><span class="Other">:</span> <span class="Identifier">T</span><span class="Other">)</span><span class="Other">:</span> <span class="Identifier">T</span> {.
    1758. 

  1758.     <span class="Identifier">inline</span>.}</pre></dt>
    1759. 

  1759.   <dd>
    1760. 

  1760.     
    1761. 

  1761.     Convert a quantity of some duration unit to another duration unit. This proc only deals with integers, so the result might be truncated.
    1762. 

  1762. <p><strong class="examples_text">Example:</strong></p>
    1763. 

  1763. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">convert</span><span class="Punctuation">(</span><span class="Identifier">Days</span><span class="Punctuation">,</span> <span class="Identifier">Hours</span><span class="Punctuation">,</span> <span class="DecNumber">2</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">48</span>
    1764. 

  1764. <span class="Identifier">doAssert</span> <span class="Identifier">convert</span><span class="Punctuation">(</span><span class="Identifier">Days</span><span class="Punctuation">,</span> <span class="Identifier">Weeks</span><span class="Punctuation">,</span> <span class="DecNumber">13</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">1</span> <span class="Comment"># Truncated</span>
    1765. 

  1765. <span class="Identifier">doAssert</span> <span class="Identifier">convert</span><span class="Punctuation">(</span><span class="Identifier">Seconds</span><span class="Punctuation">,</span> <span class="Identifier">Milliseconds</span><span class="Punctuation">,</span> <span class="Operator">-</span><span class="DecNumber">1</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Operator">-</span><span class="DecNumber">1000</span></pre>
    1766. 

  1766.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L437" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1767. 

  1767. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L437" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1768. 

  1768. 

  1769.   </dd>
    1770. 

  1770. </div>
    1771. 

  1771. 

  1772. </div>
    1773. 

  1773. <div id="cpuTime-procs-all">
    1774. 

  1774.   <div id="cpuTime">
    1775. 

  1775.   <dt><pre><span class="Keyword">proc</span> <a href="#cpuTime"><span class="Identifier">cpuTime</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#float"><span class="Identifier">float</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><a href="exceptions.html#TimeEffect"><span class="Identifier">TimeEffect</span></a><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1776. 

  1776.   <dd>
    1777. 

  1777.     
    1778. 

  1778.     Gets time spent that the CPU spent to run the current process in seconds. This may be more useful for benchmarking than <tt class="docutils literal"><span class="pre"><span class="Identifier">epochTime</span></span></tt>. However, it may measure the real time instead (depending on the OS). The value of the result has no meaning. To generate useful timing values, take the difference between the results of two <tt class="docutils literal"><span class="pre"><span class="Identifier">cpuTime</span></span></tt> calls:
    1779. 

  1779. <p><strong class="examples_text">Example:</strong></p>
    1780. 

  1780. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">t0</span> <span class="Operator">=</span> <span class="Identifier">cpuTime</span><span class="Punctuation">(</span><span class="Punctuation">)</span>
    1781. 

  1781. <span class="Comment"># some useless work here (calculate fibonacci)</span>
    1782. 

  1782. <span class="Keyword">var</span> <span class="Identifier">fib</span> <span class="Operator">=</span> <span class="Operator">@</span><span class="Punctuation">[</span><span class="DecNumber">0</span><span class="Punctuation">,</span> <span class="DecNumber">1</span><span class="Punctuation">,</span> <span class="DecNumber">1</span><span class="Punctuation">]</span>
    1783. 

  1783. <span class="Keyword">for</span> <span class="Identifier">i</span> <span class="Keyword">in</span> <span class="FloatNumber">1.</span><span class="Operator">.</span><span class="DecNumber">10</span><span class="Punctuation">:</span>
    1784. 

  1784.   <span class="Identifier">fib</span><span class="Operator">.</span><span class="Identifier">add</span><span class="Punctuation">(</span><span class="Identifier">fib</span><span class="Punctuation">[</span><span class="Operator">^</span><span class="DecNumber">1</span><span class="Punctuation">]</span> <span class="Operator">+</span> <span class="Identifier">fib</span><span class="Punctuation">[</span><span class="Operator">^</span><span class="DecNumber">2</span><span class="Punctuation">]</span><span class="Punctuation">)</span>
    1785. 

  1785. <span class="Identifier">echo</span> <span class="StringLit">&quot;CPU time [s] &quot;</span><span class="Punctuation">,</span> <span class="Identifier">cpuTime</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">-</span> <span class="Identifier">t0</span>
    1786. 

  1786. <span class="Identifier">echo</span> <span class="StringLit">&quot;Fib is [s] &quot;</span><span class="Punctuation">,</span> <span class="Identifier">fib</span></pre>When the flag <tt class="docutils literal"><span class="pre"><span class="Operator">--</span><span class="Identifier">benchmarkVM</span></span></tt> is passed to the compiler, this proc is also available at compile time
    1787. 

  1787.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2831" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1788. 

  1788. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2831" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1789. 

  1789. 

  1790.   </dd>
    1791. 

  1791. </div>
    1792. 

  1792. 

  1793. </div>
    1794. 

  1794. <div id="dateTime-procs-all">
    1795. 

  1795.   <div id="dateTime,int,Month,MonthdayRange,HourRange,MinuteRange,SecondRange,NanosecondRange,Timezone">
    1796. 

  1796.   <dt><pre><span class="Keyword">proc</span> <a href="#dateTime%2Cint%2CMonth%2CMonthdayRange%2CHourRange%2CMinuteRange%2CSecondRange%2CNanosecondRange%2CTimezone"><span class="Identifier">dateTime</span></a><span class="Other">(</span><span class="Identifier">year</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">;</span> <span class="Identifier">month</span><span class="Other">:</span> <a href="times.html#Month"><span class="Identifier">Month</span></a><span class="Other">;</span> <span class="Identifier">monthday</span><span class="Other">:</span> <a href="times.html#MonthdayRange"><span class="Identifier">MonthdayRange</span></a><span class="Other">;</span>
    1797. 

  1797.               <span class="Identifier">hour</span><span class="Other">:</span> <a href="times.html#HourRange"><span class="Identifier">HourRange</span></a> <span class="Other">=</span> <span class="DecNumber">0</span><span class="Other">;</span> <span class="Identifier">minute</span><span class="Other">:</span> <a href="times.html#MinuteRange"><span class="Identifier">MinuteRange</span></a> <span class="Other">=</span> <span class="DecNumber">0</span><span class="Other">;</span>
    1798. 

  1798.               <span class="Identifier">second</span><span class="Other">:</span> <a href="times.html#SecondRange"><span class="Identifier">SecondRange</span></a> <span class="Other">=</span> <span class="DecNumber">0</span><span class="Other">;</span> <span class="Identifier">nanosecond</span><span class="Other">:</span> <a href="times.html#NanosecondRange"><span class="Identifier">NanosecondRange</span></a> <span class="Other">=</span> <span class="DecNumber">0</span><span class="Other">;</span>
    1799. 

  1799.               <span class="Identifier">zone</span><span class="Other">:</span> <a href="times.html#Timezone"><span class="Identifier">Timezone</span></a> <span class="Other">=</span> <span class="Identifier">local</span><span class="Other">(</span><span class="Other">)</span><span class="Other">)</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1800. 

  1800.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1801. 

  1801.   <dd>
    1802. 

  1802.     
    1803. 

  1803.     Create a new <a class="reference external" href="#DateTime">DateTime</a> in the specified timezone.
    1804. 

  1804. <p><strong class="examples_text">Example:</strong></p>
    1805. 

  1805. <pre class="listing"><span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">dateTime</span><span class="Punctuation">(</span><span class="DecNumber">2017</span><span class="Punctuation">,</span> <span class="Identifier">mMar</span><span class="Punctuation">,</span> <span class="DecNumber">30</span><span class="Punctuation">,</span> <span class="Identifier">zone</span> <span class="Operator">=</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;2017-03-30T00:00:00Z&quot;</span></pre>
    1806. 

  1806.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1419" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1807. 

  1807. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1419" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1808. 

  1808. 

  1809.   </dd>
    1810. 

  1810. </div>
    1811. 

  1811. 

  1812. </div>
    1813. 

  1813. <div id="days-procs-all">
    1814. 

  1814.   <div id="days,int">
    1815. 

  1815.   <dt><pre><span class="Keyword">proc</span> <a href="#days%2Cint"><span class="Identifier">days</span></a><span class="Other">(</span><span class="Identifier">d</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1816. 

  1816.   <dd>
    1817. 

  1817.     
    1818. 

  1818.     <p>TimeInterval of <tt class="docutils literal"><span class="pre"><span class="Identifier">d</span></span></tt> days.</p>
    1819. 

  1819. <p><tt class="docutils literal"><span class="pre"><span class="Identifier">echo</span> <span class="Identifier">getTime</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">+</span> <span class="FloatNumber">2.</span><span class="Identifier">days</span></span></tt></p>
    1820. 

  1820. 

  1821.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2616" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1822. 

  1822. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2616" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1823. 

  1823. 

  1824.   </dd>
    1825. 

  1825. </div>
    1826. 

  1826. 

  1827. </div>
    1828. 

  1828. <div id="div-procs-all">
    1829. 

  1829.   <div id="div,Duration,int64">
    1830. 

  1830.   <dt><pre><span class="Keyword">proc</span> <a href="#div%2CDuration%2Cint64"><span class="Identifier">`div`</span></a><span class="Other">(</span><span class="Identifier">a</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">;</span> <span class="Identifier">b</span><span class="Other">:</span> <a href="system.html#int64"><span class="Identifier">int64</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> </span><span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span>
    1831. 

  1831.     <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;ntDivDuration&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1832. 

  1832.   <dd>
    1833. 

  1833.     
    1834. 

  1834.     Integer division for durations.
    1835. 

  1835. <p><strong class="examples_text">Example:</strong></p>
    1836. 

  1836. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="DecNumber">3</span><span class="Punctuation">)</span> <span class="Keyword">div</span> <span class="DecNumber">2</span> <span class="Operator">==</span>
    1837. 

  1837.   <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">milliseconds</span> <span class="Operator">=</span> <span class="DecNumber">1500</span><span class="Punctuation">)</span>
    1838. 

  1838. <span class="Identifier">doAssert</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">minutes</span> <span class="Operator">=</span> <span class="DecNumber">45</span><span class="Punctuation">)</span> <span class="Keyword">div</span> <span class="DecNumber">30</span> <span class="Operator">==</span>
    1839. 

  1839.   <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">minutes</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">,</span> <span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="DecNumber">30</span><span class="Punctuation">)</span>
    1840. 

  1840. <span class="Identifier">doAssert</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">nanoseconds</span> <span class="Operator">=</span> <span class="DecNumber">3</span><span class="Punctuation">)</span> <span class="Keyword">div</span> <span class="DecNumber">2</span> <span class="Operator">==</span>
    1841. 

  1841.   <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">nanoseconds</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">)</span></pre>
    1842. 

  1842.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L884" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1843. 

  1843. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L884" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1844. 

  1844. 

  1845.   </dd>
    1846. 

  1846. </div>
    1847. 

  1847. 

  1848. </div>
    1849. 

  1849. <div id="epochTime-procs-all">
    1850. 

  1850.   <div id="epochTime">
    1851. 

  1851.   <dt><pre><span class="Keyword">proc</span> <a href="#epochTime"><span class="Identifier">epochTime</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#float"><span class="Identifier">float</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><a href="exceptions.html#TimeEffect"><span class="Identifier">TimeEffect</span></a><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1852. 

  1852.   <dd>
    1853. 

  1853.     
    1854. 

  1854.     <p>Gets time after the UNIX epoch (1970) in seconds. It is a float because sub-second resolution is likely to be supported (depending on the hardware/OS).</p>
    1855. 

  1855. <p><tt class="docutils literal"><span class="pre"><span class="Identifier">getTime</span></span></tt> should generally be preferred over this proc.</p>
    1856. 

  1856. <div class="admonition admonition-warning"><span class="admonition-warning-text"><b>Warning:</b></span>
    1857. 

  1857. Unsuitable for benchmarking (but still better than <tt class="docutils literal"><span class="pre"><span class="Identifier">now</span></span></tt>), use <tt class="docutils literal"><span class="pre"><span class="Identifier">monotimes</span><span class="Operator">.</span><span class="Identifier">getMonoTime</span></span></tt> or <tt class="docutils literal"><span class="pre"><span class="Identifier">cpuTime</span></span></tt> instead, depending on the use case.</div>
    1858. 

  1858. 

  1859.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2790" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1860. 

  1860. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2790" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1861. 

  1861. 

  1862.   </dd>
    1863. 

  1863. </div>
    1864. 

  1864. 

  1865. </div>
    1866. 

  1866. <div id="format-procs-all">
    1867. 

  1867.   <div id="format,DateTime,static[string]">
    1868. 

  1868.   <dt><pre><span class="Keyword">proc</span> <a href="#format%2CDateTime%2Cstatic%5Bstring%5D"><span class="Identifier">format</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">;</span> <span class="Identifier">f</span><span class="Other">:</span> <a href="system.html#static"><span class="Identifier">static</span></a><span class="Other">[</span><a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1869. 

  1869.   <dd>
    1870. 

  1870.     
    1871. 

  1871.     Overload that validates <tt class="docutils literal"><span class="pre"><span class="Identifier">format</span></span></tt> at compile time.
    1872. 

  1872.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2217" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1873. 

  1873. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2217" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1874. 

  1874. 

  1875.   </dd>
    1876. 

  1876. </div>
    1877. 

  1877. <div id="format,DateTime,string,DateTimeLocale">
    1878. 

  1878.   <dt><pre><span class="Keyword">proc</span> <a href="#format%2CDateTime%2Cstring%2CDateTimeLocale"><span class="Identifier">format</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">;</span> <span class="Identifier">f</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">loc</span><span class="Other">:</span> <a href="times.html#DateTimeLocale"><span class="Identifier">DateTimeLocale</span></a> <span class="Other">=</span> <span class="Identifier">DefaultLocale</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.
    1879. 

  1879.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><a href="times.html#TimeFormatParseError"><span class="Identifier">TimeFormatParseError</span></a><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1880. 

  1880.   <dd>
    1881. 

  1881.     
    1882. 

  1882.     <p>Shorthand for constructing a <tt class="docutils literal"><span class="pre"><span class="Identifier">TimeFormat</span></span></tt> and using it to format <tt class="docutils literal"><span class="pre"><span class="Identifier">dt</span></span></tt>.</p>
    1883. 

  1883. <p>See <a class="reference internal" href="#parsing-and-formatting-dates">Parsing and formatting dates</a> for documentation of the <tt class="docutils literal"><span class="pre"><span class="Identifier">format</span></span></tt> argument.</p>
    1884. 

  1884. 

  1885. <p><strong class="examples_text">Example:</strong></p>
    1886. 

  1886. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">dt</span> <span class="Operator">=</span> <span class="Identifier">dateTime</span><span class="Punctuation">(</span><span class="DecNumber">2000</span><span class="Punctuation">,</span> <span class="Identifier">mJan</span><span class="Punctuation">,</span> <span class="DecNumber">01</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
    1887. 

  1887. <span class="Identifier">doAssert</span> <span class="StringLit">&quot;2000-01-01&quot;</span> <span class="Operator">==</span> <span class="Identifier">format</span><span class="Punctuation">(</span><span class="Identifier">dt</span><span class="Punctuation">,</span> <span class="StringLit">&quot;yyyy-MM-dd&quot;</span><span class="Punctuation">)</span></pre>
    1888. 

  1888.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2205" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1889. 

  1889. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2205" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1890. 

  1890. 

  1891.   </dd>
    1892. 

  1892. </div>
    1893. 

  1893. <div id="format,DateTime,TimeFormat,DateTimeLocale">
    1894. 

  1894.   <dt><pre><span class="Keyword">proc</span> <a href="#format%2CDateTime%2CTimeFormat%2CDateTimeLocale"><span class="Identifier">format</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">;</span> <span class="Identifier">f</span><span class="Other">:</span> <a href="times.html#TimeFormat"><span class="Identifier">TimeFormat</span></a><span class="Other">;</span> <span class="Identifier">loc</span><span class="Other">:</span> <a href="times.html#DateTimeLocale"><span class="Identifier">DateTimeLocale</span></a> <span class="Other">=</span> <span class="Identifier">DefaultLocale</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.
    1895. 

  1895.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1896. 

  1896.   <dd>
    1897. 

  1897.     
    1898. 

  1898.     Format <tt class="docutils literal"><span class="pre"><span class="Identifier">dt</span></span></tt> using the format specified by <tt class="docutils literal"><span class="pre"><span class="Identifier">f</span></span></tt>.
    1899. 

  1899. <p><strong class="examples_text">Example:</strong></p>
    1900. 

  1900. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">f</span> <span class="Operator">=</span> <span class="Identifier">initTimeFormat</span><span class="Punctuation">(</span><span class="StringLit">&quot;yyyy-MM-dd&quot;</span><span class="Punctuation">)</span>
    1901. 

  1901. <span class="Keyword">let</span> <span class="Identifier">dt</span> <span class="Operator">=</span> <span class="Identifier">dateTime</span><span class="Punctuation">(</span><span class="DecNumber">2000</span><span class="Punctuation">,</span> <span class="Identifier">mJan</span><span class="Punctuation">,</span> <span class="DecNumber">01</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
    1902. 

  1902. <span class="Identifier">doAssert</span> <span class="StringLit">&quot;2000-01-01&quot;</span> <span class="Operator">==</span> <span class="Identifier">dt</span><span class="Operator">.</span><span class="Identifier">format</span><span class="Punctuation">(</span><span class="Identifier">f</span><span class="Punctuation">)</span></pre>
    1903. 

  1903.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2182" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1904. 

  1904. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2182" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1905. 

  1905. 

  1906.   </dd>
    1907. 

  1907. </div>
    1908. 

  1908. <div id="format,Time,static[string],Timezone">
    1909. 

  1909.   <dt><pre><span class="Keyword">proc</span> <a href="#format%2CTime%2Cstatic%5Bstring%5D%2CTimezone"><span class="Identifier">format</span></a><span class="Other">(</span><span class="Identifier">time</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">;</span> <span class="Identifier">f</span><span class="Other">:</span> <a href="system.html#static"><span class="Identifier">static</span></a><span class="Other">[</span><a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">zone</span><span class="Other">:</span> <a href="times.html#Timezone"><span class="Identifier">Timezone</span></a> <span class="Other">=</span> <span class="Identifier">local</span><span class="Other">(</span><span class="Other">)</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.
    1910. 

  1910.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1911. 

  1911.   <dd>
    1912. 

  1912.     
    1913. 

  1913.     Overload that validates <tt class="docutils literal"><span class="pre"><span class="Identifier">f</span></span></tt> at compile time.
    1914. 

  1914.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2240" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1915. 

  1915. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2240" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1916. 

  1916. 

  1917.   </dd>
    1918. 

  1918. </div>
    1919. 

  1919. <div id="format,Time,string,Timezone">
    1920. 

  1920.   <dt><pre><span class="Keyword">proc</span> <a href="#format%2CTime%2Cstring%2CTimezone"><span class="Identifier">format</span></a><span class="Other">(</span><span class="Identifier">time</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">;</span> <span class="Identifier">f</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">zone</span><span class="Other">:</span> <a href="times.html#Timezone"><span class="Identifier">Timezone</span></a> <span class="Other">=</span> <span class="Identifier">local</span><span class="Other">(</span><span class="Other">)</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.
    1921. 

  1921.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><a href="times.html#TimeFormatParseError"><span class="Identifier">TimeFormatParseError</span></a><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1922. 

  1922.   <dd>
    1923. 

  1923.     
    1924. 

  1924.     <p>Shorthand for constructing a <tt class="docutils literal"><span class="pre"><span class="Identifier">TimeFormat</span></span></tt> and using it to format <tt class="docutils literal"><span class="pre"><span class="Identifier">time</span></span></tt>. Will use the timezone specified by <tt class="docutils literal"><span class="pre"><span class="Identifier">zone</span></span></tt>.</p>
    1925. 

  1925. <p>See <a class="reference internal" href="#parsing-and-formatting-dates">Parsing and formatting dates</a> for documentation of the <tt class="docutils literal"><span class="pre"><span class="Identifier">f</span></span></tt> argument.</p>
    1926. 

  1926. 

  1927. <p><strong class="examples_text">Example:</strong></p>
    1928. 

  1928. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">dt</span> <span class="Operator">=</span> <span class="Identifier">dateTime</span><span class="Punctuation">(</span><span class="DecNumber">1970</span><span class="Punctuation">,</span> <span class="Identifier">mJan</span><span class="Punctuation">,</span> <span class="DecNumber">01</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
    1929. 

  1929. <span class="Keyword">var</span> <span class="Identifier">tm</span> <span class="Operator">=</span> <span class="Identifier">dt</span><span class="Operator">.</span><span class="Identifier">toTime</span><span class="Punctuation">(</span><span class="Punctuation">)</span>
    1930. 

  1930. <span class="Identifier">doAssert</span> <span class="Identifier">format</span><span class="Punctuation">(</span><span class="Identifier">tm</span><span class="Punctuation">,</span> <span class="StringLit">&quot;yyyy-MM-dd'T'HH:mm:ss&quot;</span><span class="Punctuation">,</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;1970-01-01T00:00:00&quot;</span></pre>
    1931. 

  1931.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2227" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1932. 

  1932. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2227" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1933. 

  1933. 

  1934.   </dd>
    1935. 

  1935. </div>
    1936. 

  1936. 

  1937. </div>
    1938. 

  1938. <div id="formatValue-procs-all">
    1939. 

  1939.   <div id="formatValue,string,,string">
    1940. 

  1940.   <dt><pre><span class="Keyword">proc</span> <a href="#formatValue%2Cstring%2C%2Cstring"><span class="Identifier">formatValue</span></a><span class="Other">(</span><span class="Identifier">result</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">value</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a> <span class="Operator">|</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">;</span> <span class="Identifier">specifier</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span></pre></dt>
    1941. 

  1941.   <dd>
    1942. 

  1942.     
    1943. 

  1943.     adapter for strformat. Not intended to be called directly.
    1944. 

  1944.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2222" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1945. 

  1945. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2222" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1946. 

  1946. 

  1947.   </dd>
    1948. 

  1948. </div>
    1949. 

  1949. 

  1950. </div>
    1951. 

  1951. <div id="fromUnix-procs-all">
    1952. 

  1952.   <div id="fromUnix,int64">
    1953. 

  1953.   <dt><pre><span class="Keyword">proc</span> <a href="#fromUnix%2Cint64"><span class="Identifier">fromUnix</span></a><span class="Other">(</span><span class="Identifier">unix</span><span class="Other">:</span> <a href="system.html#int64"><span class="Identifier">int64</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">noSideEffect</span><span class="Other">,</span>
    1954. 

  1954.                                    <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1955. 

  1955.   <dd>
    1956. 

  1956.     
    1957. 

  1957.     Convert a unix timestamp (seconds since <tt class="docutils literal"><span class="pre"><span class="DecNumber">1970</span><span class="Operator">-</span><span class="DecNumber">01</span><span class="Operator">-</span><span class="DecNumber">01</span><span class="Identifier">T00</span><span class="Punctuation">:</span><span class="DecNumber">00</span><span class="Punctuation">:</span><span class="DecNumber">00</span><span class="Identifier">Z</span></span></tt>) to a <tt class="docutils literal"><span class="pre"><span class="Identifier">Time</span></span></tt>.
    1958. 

  1958. <p><strong class="examples_text">Example:</strong></p>
    1959. 

  1959. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Operator">$</span><span class="Identifier">fromUnix</span><span class="Punctuation">(</span><span class="DecNumber">0</span><span class="Punctuation">)</span><span class="Operator">.</span><span class="Identifier">utc</span> <span class="Operator">==</span> <span class="StringLit">&quot;1970-01-01T00:00:00Z&quot;</span></pre>
    1960. 

  1960.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L924" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1961. 

  1961. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L924" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1962. 

  1962. 

  1963.   </dd>
    1964. 

  1964. </div>
    1965. 

  1965. 

  1966. </div>
    1967. 

  1967. <div id="fromUnixFloat-procs-all">
    1968. 

  1968.   <div id="fromUnixFloat,float">
    1969. 

  1969.   <dt><pre><span class="Keyword">proc</span> <a href="#fromUnixFloat%2Cfloat"><span class="Identifier">fromUnixFloat</span></a><span class="Other">(</span><span class="Identifier">seconds</span><span class="Other">:</span> <a href="system.html#float"><span class="Identifier">float</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1970. 

  1970.     </span><span class="Identifier">noSideEffect</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1971. 

  1971.   <dd>
    1972. 

  1972.     
    1973. 

  1973.     Convert a unix timestamp in seconds to a <tt class="docutils literal"><span class="pre"><span class="Identifier">Time</span></span></tt>; same as <tt class="docutils literal"><span class="pre"><span class="Identifier">fromUnix</span></span></tt> but with subsecond resolution.
    1974. 

  1974. <p><strong class="examples_text">Example:</strong></p>
    1975. 

  1975. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">fromUnixFloat</span><span class="Punctuation">(</span><span class="FloatNumber">123456.0</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">fromUnixFloat</span><span class="Punctuation">(</span><span class="DecNumber">123456</span><span class="Punctuation">)</span>
    1976. 

  1976. <span class="Identifier">doAssert</span> <span class="Identifier">fromUnixFloat</span><span class="Punctuation">(</span><span class="Operator">-</span><span class="FloatNumber">123456.0</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">fromUnixFloat</span><span class="Punctuation">(</span><span class="Operator">-</span><span class="DecNumber">123456</span><span class="Punctuation">)</span></pre>
    1977. 

  1977.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L939" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1978. 

  1978. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L939" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1979. 

  1979. 

  1980.   </dd>
    1981. 

  1981. </div>
    1982. 

  1982. 

  1983. </div>
    1984. 

  1984. <div id="fromWinTime-procs-all">
    1985. 

  1985.   <div id="fromWinTime,int64">
    1986. 

  1986.   <dt><pre><span class="Keyword">proc</span> <a href="#fromWinTime%2Cint64"><span class="Identifier">fromWinTime</span></a><span class="Other">(</span><span class="Identifier">win</span><span class="Other">:</span> <a href="system.html#int64"><span class="Identifier">int64</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1987. 

  1987.   <dd>
    1988. 

  1988.     
    1989. 

  1989.     Convert a Windows file time (100-nanosecond intervals since <tt class="docutils literal"><span class="pre"><span class="DecNumber">1601</span><span class="Operator">-</span><span class="DecNumber">01</span><span class="Operator">-</span><span class="DecNumber">01</span><span class="Identifier">T00</span><span class="Punctuation">:</span><span class="DecNumber">00</span><span class="Punctuation">:</span><span class="DecNumber">00</span><span class="Identifier">Z</span></span></tt>) to a <tt class="docutils literal"><span class="pre"><span class="Identifier">Time</span></span></tt>.
    1990. 

  1990.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L962" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1991. 

  1991. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L962" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1992. 

  1992. 

  1993.   </dd>
    1994. 

  1994. </div>
    1995. 

  1995. 

  1996. </div>
    1997. 

  1997. <div id="getClockStr-procs-all">
    1998. 

  1998.   <div id="getClockStr">
    1999. 

  1999.   <dt><pre><span class="Keyword">proc</span> <a href="#getClockStr"><span class="Identifier">getClockStr</span></a><span class="Other">(</span><span class="Identifier">dt</span> <span class="Other">=</span> <span class="Identifier">now</span><span class="Other">(</span><span class="Other">)</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nt$1&quot;</span><span class="Other">,</span>
    2000. 

  2000.                                        <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><a href="exceptions.html#TimeEffect"><span class="Identifier">TimeEffect</span></a><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    2001. 

  2001.                                        <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2002. 

  2002.   <dd>
    2003. 

  2003.     
    2004. 

  2004.     Gets the current local clock time as a string of the format <tt class="docutils literal"><span class="pre"><span class="Identifier">HH</span><span class="Punctuation">:</span><span class="Identifier">mm</span><span class="Punctuation">:</span><span class="Identifier">ss</span></span></tt>.
    2005. 

  2005. <p><strong class="examples_text">Example:</strong></p>
    2006. 

  2006. <pre class="listing"><span class="Identifier">echo</span> <span class="Identifier">getClockStr</span><span class="Punctuation">(</span><span class="Identifier">now</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">-</span> <span class="FloatNumber">1.</span><span class="Identifier">hours</span><span class="Punctuation">)</span></pre>
    2007. 

  2007.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1514" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2008. 

  2008. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1514" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2009. 

  2009. 

  2010.   </dd>
    2011. 

  2011. </div>
    2012. 

  2012. 

  2013. </div>
    2014. 

  2014. <div id="getDateStr-procs-all">
    2015. 

  2015.   <div id="getDateStr">
    2016. 

  2016.   <dt><pre><span class="Keyword">proc</span> <a href="#getDateStr"><span class="Identifier">getDateStr</span></a><span class="Other">(</span><span class="Identifier">dt</span> <span class="Other">=</span> <span class="Identifier">now</span><span class="Other">(</span><span class="Other">)</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">extern</span><span class="Other">:</span> <span class="StringLit">&quot;nt$1&quot;</span><span class="Other">,</span>
    2017. 

  2017.                                       <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><a href="exceptions.html#TimeEffect"><span class="Identifier">TimeEffect</span></a><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    2018. 

  2018.                                       <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2019. 

  2019.   <dd>
    2020. 

  2020.     
    2021. 

  2021.     Gets the current local date as a string of the format <tt class="docutils literal"><span class="pre"><span class="Identifier">YYYY</span><span class="Operator">-</span><span class="Identifier">MM</span><span class="Operator">-</span><span class="Identifier">dd</span></span></tt>.
    2022. 

  2022. <p><strong class="examples_text">Example:</strong></p>
    2023. 

  2023. <pre class="listing"><span class="Identifier">echo</span> <span class="Identifier">getDateStr</span><span class="Punctuation">(</span><span class="Identifier">now</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">-</span> <span class="FloatNumber">1.</span><span class="Identifier">months</span><span class="Punctuation">)</span></pre>
    2024. 

  2024.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1502" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2025. 

  2025. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1502" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2026. 

  2026. 

  2027.   </dd>
    2028. 

  2028. </div>
    2029. 

  2029. 

  2030. </div>
    2031. 

  2031. <div id="getDayOfWeek-procs-all">
    2032. 

  2032.   <div id="getDayOfWeek,MonthdayRange,Month,int">
    2033. 

  2033.   <dt><pre><span class="Keyword">proc</span> <a href="#getDayOfWeek%2CMonthdayRange%2CMonth%2Cint"><span class="Identifier">getDayOfWeek</span></a><span class="Other">(</span><span class="Identifier">monthday</span><span class="Other">:</span> <a href="times.html#MonthdayRange"><span class="Identifier">MonthdayRange</span></a><span class="Other">;</span> <span class="Identifier">month</span><span class="Other">:</span> <a href="times.html#Month"><span class="Identifier">Month</span></a><span class="Other">;</span> <span class="Identifier">year</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#WeekDay"><span class="Identifier">WeekDay</span></a> {.
    2034. 

  2034.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2035. 

  2035.   <dd>
    2036. 

  2036.     
    2037. 

  2037.     Returns the day of the week enum from day, month and year. Equivalent with <tt class="docutils literal"><span class="pre"><span class="Identifier">dateTime</span><span class="Punctuation">(</span><span class="Identifier">year</span><span class="Punctuation">,</span> <span class="Identifier">month</span><span class="Punctuation">,</span> <span class="Identifier">monthday</span><span class="Punctuation">,</span> <span class="DecNumber">0</span><span class="Punctuation">,</span> <span class="DecNumber">0</span><span class="Punctuation">,</span> <span class="DecNumber">0</span><span class="Punctuation">,</span> <span class="DecNumber">0</span><span class="Punctuation">)</span><span class="Operator">.</span><span class="Identifier">weekday</span></span></tt>.
    2038. 

  2038. <p><strong class="examples_text">Example:</strong></p>
    2039. 

  2039. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">getDayOfWeek</span><span class="Punctuation">(</span><span class="DecNumber">13</span><span class="Punctuation">,</span> <span class="Identifier">mJun</span><span class="Punctuation">,</span> <span class="DecNumber">1990</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">dWed</span>
    2040. 

  2040. <span class="Identifier">doAssert</span> <span class="Operator">$</span><span class="Identifier">getDayOfWeek</span><span class="Punctuation">(</span><span class="DecNumber">13</span><span class="Punctuation">,</span> <span class="Identifier">mJun</span><span class="Punctuation">,</span> <span class="DecNumber">1990</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;Wednesday&quot;</span></pre>
    2041. 

  2041.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L540" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2042. 

  2042. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L540" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2043. 

  2043. 

  2044.   </dd>
    2045. 

  2045. </div>
    2046. 

  2046. 

  2047. </div>
    2048. 

  2048. <div id="getDayOfYear-procs-all">
    2049. 

  2049.   <div id="getDayOfYear,MonthdayRange,Month,int">
    2050. 

  2050.   <dt><pre><span class="Keyword">proc</span> <a href="#getDayOfYear%2CMonthdayRange%2CMonth%2Cint"><span class="Identifier">getDayOfYear</span></a><span class="Other">(</span><span class="Identifier">monthday</span><span class="Other">:</span> <a href="times.html#MonthdayRange"><span class="Identifier">MonthdayRange</span></a><span class="Other">;</span> <span class="Identifier">month</span><span class="Other">:</span> <a href="times.html#Month"><span class="Identifier">Month</span></a><span class="Other">;</span> <span class="Identifier">year</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#YeardayRange"><span class="Identifier">YeardayRange</span></a> {.
    2051. 

  2051.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2052. 

  2052.   <dd>
    2053. 

  2053.     
    2054. 

  2054.     Returns the day of the year. Equivalent with <tt class="docutils literal"><span class="pre"><span class="Identifier">dateTime</span><span class="Punctuation">(</span><span class="Identifier">year</span><span class="Punctuation">,</span> <span class="Identifier">month</span><span class="Punctuation">,</span> <span class="Identifier">monthday</span><span class="Punctuation">,</span> <span class="DecNumber">0</span><span class="Punctuation">,</span> <span class="DecNumber">0</span><span class="Punctuation">,</span> <span class="DecNumber">0</span><span class="Punctuation">,</span> <span class="DecNumber">0</span><span class="Punctuation">)</span><span class="Operator">.</span><span class="Identifier">yearday</span></span></tt>.
    2055. 

  2055. <p><strong class="examples_text">Example:</strong></p>
    2056. 

  2056. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">getDayOfYear</span><span class="Punctuation">(</span><span class="DecNumber">1</span><span class="Punctuation">,</span> <span class="Identifier">mJan</span><span class="Punctuation">,</span> <span class="DecNumber">2000</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">0</span>
    2057. 

  2057. <span class="Identifier">doAssert</span> <span class="Identifier">getDayOfYear</span><span class="Punctuation">(</span><span class="DecNumber">10</span><span class="Punctuation">,</span> <span class="Identifier">mJan</span><span class="Punctuation">,</span> <span class="DecNumber">2000</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">9</span>
    2058. 

  2058. <span class="Identifier">doAssert</span> <span class="Identifier">getDayOfYear</span><span class="Punctuation">(</span><span class="DecNumber">10</span><span class="Punctuation">,</span> <span class="Identifier">mFeb</span><span class="Punctuation">,</span> <span class="DecNumber">2000</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">40</span></pre>
    2059. 

  2059.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L520" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2060. 

  2060. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L520" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2061. 

  2061. 

  2062.   </dd>
    2063. 

  2063. </div>
    2064. 

  2064. 

  2065. </div>
    2066. 

  2066. <div id="getDaysInMonth-procs-all">
    2067. 

  2067.   <div id="getDaysInMonth,Month,int">
    2068. 

  2068.   <dt><pre><span class="Keyword">proc</span> <a href="#getDaysInMonth%2CMonth%2Cint"><span class="Identifier">getDaysInMonth</span></a><span class="Other">(</span><span class="Identifier">month</span><span class="Other">:</span> <a href="times.html#Month"><span class="Identifier">Month</span></a><span class="Other">;</span> <span class="Identifier">year</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    2069. 

  2069.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2070. 

  2070.   <dd>
    2071. 

  2071.     
    2072. 

  2072.     Get the number of days in <tt class="docutils literal"><span class="pre"><span class="Identifier">month</span></span></tt> of <tt class="docutils literal"><span class="pre"><span class="Identifier">year</span></span></tt>.
    2073. 

  2073. <p><strong class="examples_text">Example:</strong></p>
    2074. 

  2074. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">getDaysInMonth</span><span class="Punctuation">(</span><span class="Identifier">mFeb</span><span class="Punctuation">,</span> <span class="DecNumber">2000</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">29</span>
    2075. 

  2075. <span class="Identifier">doAssert</span> <span class="Identifier">getDaysInMonth</span><span class="Punctuation">(</span><span class="Identifier">mFeb</span><span class="Punctuation">,</span> <span class="DecNumber">2001</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">28</span></pre>
    2076. 

  2076.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L469" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2077. 

  2077. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L469" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2078. 

  2078. 

  2079.   </dd>
    2080. 

  2080. </div>
    2081. 

  2081. 

  2082. </div>
    2083. 

  2083. <div id="getDaysInYear-procs-all">
    2084. 

  2084.   <div id="getDaysInYear,int">
    2085. 

  2085.   <dt><pre><span class="Keyword">proc</span> <a href="#getDaysInYear%2Cint"><span class="Identifier">getDaysInYear</span></a><span class="Other">(</span><span class="Identifier">year</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2086. 

  2086.   <dd>
    2087. 

  2087.     
    2088. 

  2088.     Get the number of days in a <tt class="docutils literal"><span class="pre"><span class="Identifier">year</span></span></tt>
    2089. 

  2089. <p><strong class="examples_text">Example:</strong></p>
    2090. 

  2090. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">getDaysInYear</span><span class="Punctuation">(</span><span class="DecNumber">2000</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">366</span>
    2091. 

  2091. <span class="Identifier">doAssert</span> <span class="Identifier">getDaysInYear</span><span class="Punctuation">(</span><span class="DecNumber">2001</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">365</span></pre>
    2092. 

  2092.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L557" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2093. 

  2093. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L557" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2094. 

  2094. 

  2095.   </dd>
    2096. 

  2096. </div>
    2097. 

  2097. 

  2098. </div>
    2099. 

  2099. <div id="getIsoWeekAndYear-procs-all">
    2100. 

  2100.   <div id="getIsoWeekAndYear,DateTime">
    2101. 

  2101.   <dt><pre><span class="Keyword">proc</span> <a href="#getIsoWeekAndYear%2CDateTime"><span class="Identifier">getIsoWeekAndYear</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">)</span><span class="Other">:</span> <span class="Keyword">tuple</span><span class="Other">[</span><span class="Identifier">isoweek</span><span class="Other">:</span> <a href="times.html#IsoWeekRange"><span class="Identifier">IsoWeekRange</span></a><span class="Other">,</span>
    2102. 

  2102.     <span class="Identifier">isoyear</span><span class="Other">:</span> <a href="times.html#IsoYear"><span class="Identifier">IsoYear</span></a><span class="Other">]</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2103. 

  2103.   <dd>
    2104. 

  2104.     
    2105. 

  2105.     Returns the ISO 8601 week and year.<div class="admonition admonition-warning"><span class="admonition-warning-text"><b>Warning:</b></span>
    2106. 

  2106. The ISO week-based year can correspond to the following or previous year from 29 December to January 3.</div>
    2107. 

  2107. 

  2108. <p><strong class="examples_text">Example:</strong></p>
    2109. 

  2109. <pre class="listing"><span class="Identifier">assert</span> <span class="Identifier">getIsoWeekAndYear</span><span class="Punctuation">(</span><span class="Identifier">initDateTime</span><span class="Punctuation">(</span><span class="DecNumber">21</span><span class="Punctuation">,</span> <span class="Identifier">mApr</span><span class="Punctuation">,</span> <span class="DecNumber">2018</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">)</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Punctuation">(</span><span class="Identifier">isoweek</span><span class="Punctuation">:</span> <span class="FloatNumber">16.</span><span class="Identifier">IsoWeekRange</span><span class="Punctuation">,</span> <span class="Identifier">isoyear</span><span class="Punctuation">:</span> <span class="FloatNumber">2018.</span><span class="Identifier">IsoYear</span><span class="Punctuation">)</span>
    2110. 

  2110. <span class="Keyword">block</span><span class="Punctuation">:</span>
    2111. 

  2111.   <span class="Keyword">let</span> <span class="Punctuation">(</span><span class="Identifier">w</span><span class="Punctuation">,</span> <span class="Identifier">y</span><span class="Punctuation">)</span> <span class="Operator">=</span> <span class="Identifier">getIsoWeekAndYear</span><span class="Punctuation">(</span><span class="Identifier">initDateTime</span><span class="Punctuation">(</span><span class="DecNumber">30</span><span class="Punctuation">,</span> <span class="Identifier">mDec</span><span class="Punctuation">,</span> <span class="DecNumber">2019</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
    2112. 

  2112.   <span class="Identifier">assert</span> <span class="Identifier">w</span> <span class="Operator">==</span> <span class="FloatNumber">01.</span><span class="Identifier">IsoWeekRange</span>
    2113. 

  2113.   <span class="Identifier">assert</span> <span class="Identifier">y</span> <span class="Operator">==</span> <span class="FloatNumber">2020.</span><span class="Identifier">IsoYear</span>
    2114. 

  2114. <span class="Identifier">assert</span> <span class="Identifier">getIsoWeekAndYear</span><span class="Punctuation">(</span><span class="Identifier">initDateTime</span><span class="Punctuation">(</span><span class="DecNumber">13</span><span class="Punctuation">,</span> <span class="Identifier">mSep</span><span class="Punctuation">,</span> <span class="DecNumber">2020</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">)</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Punctuation">(</span><span class="Identifier">isoweek</span><span class="Punctuation">:</span> <span class="FloatNumber">37.</span><span class="Identifier">IsoWeekRange</span><span class="Punctuation">,</span> <span class="Identifier">isoyear</span><span class="Punctuation">:</span> <span class="FloatNumber">2020.</span><span class="Identifier">IsoYear</span><span class="Punctuation">)</span>
    2115. 

  2115. <span class="Keyword">block</span><span class="Punctuation">:</span>
    2116. 

  2116.   <span class="Keyword">let</span> <span class="Punctuation">(</span><span class="Identifier">w</span><span class="Punctuation">,</span> <span class="Identifier">y</span><span class="Punctuation">)</span> <span class="Operator">=</span> <span class="Identifier">getIsoWeekAndYear</span><span class="Punctuation">(</span><span class="Identifier">initDateTime</span><span class="Punctuation">(</span><span class="DecNumber">2</span><span class="Punctuation">,</span> <span class="Identifier">mJan</span><span class="Punctuation">,</span> <span class="DecNumber">2021</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
    2117. 

  2117.   <span class="Identifier">assert</span> <span class="Identifier">w</span><span class="Operator">.</span><span class="Identifier">int</span> <span class="Operator">&gt;</span> <span class="DecNumber">52</span>
    2118. 

  2118.   <span class="Identifier">assert</span> <span class="Identifier">w</span><span class="Operator">.</span><span class="Identifier">int</span> <span class="Operator">&lt;</span> <span class="DecNumber">54</span>
    2119. 

  2119.   <span class="Identifier">assert</span> <span class="Identifier">y</span><span class="Operator">.</span><span class="Identifier">int</span> <span class="Keyword">mod</span> <span class="DecNumber">100</span> <span class="Operator">==</span> <span class="DecNumber">20</span></pre>
    2120. 

  2120.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L585" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2121. 

  2121. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L585" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2122. 

  2122. 

  2123.   </dd>
    2124. 

  2124. </div>
    2125. 

  2125. 

  2126. </div>
    2127. 

  2127. <div id="getTime-procs-all">
    2128. 

  2128.   <div id="getTime">
    2129. 

  2129.   <dt><pre><span class="Keyword">proc</span> <a href="#getTime"><span class="Identifier">getTime</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><a href="exceptions.html#TimeEffect"><span class="Identifier">TimeEffect</span></a><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2130. 

  2130.   <dd>
    2131. 

  2131.     
    2132. 

  2132.     Gets the current time as a <tt class="docutils literal"><span class="pre"><span class="Identifier">Time</span></span></tt> with up to nanosecond resolution.
    2133. 

  2133.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L978" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2134. 

  2134. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L978" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2135. 

  2135. 

  2136.   </dd>
    2137. 

  2137. </div>
    2138. 

  2138. 

  2139. </div>
    2140. 

  2140. <div id="getWeeksInIsoYear-procs-all">
    2141. 

  2141.   <div id="getWeeksInIsoYear,IsoYear">
    2142. 

  2142.   <dt><pre><span class="Keyword">proc</span> <a href="#getWeeksInIsoYear%2CIsoYear"><span class="Identifier">getWeeksInIsoYear</span></a><span class="Other">(</span><span class="Identifier">y</span><span class="Other">:</span> <a href="times.html#IsoYear"><span class="Identifier">IsoYear</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#IsoWeekRange"><span class="Identifier">IsoWeekRange</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    2143. 

  2143.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2144. 

  2144.   <dd>
    2145. 

  2145.     
    2146. 

  2146.     Returns the number of weeks in the specified ISO 8601 week-based year, which can be either 53 or 52.
    2147. 

  2147. <p><strong class="examples_text">Example:</strong></p>
    2148. 

  2148. <pre class="listing"><span class="Identifier">assert</span> <span class="Identifier">getWeeksInIsoYear</span><span class="Punctuation">(</span><span class="Identifier">IsoYear</span><span class="Punctuation">(</span><span class="DecNumber">2019</span><span class="Punctuation">)</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">52</span>
    2149. 

  2149. <span class="Identifier">assert</span> <span class="Identifier">getWeeksInIsoYear</span><span class="Punctuation">(</span><span class="Identifier">IsoYear</span><span class="Punctuation">(</span><span class="DecNumber">2020</span><span class="Punctuation">)</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">53</span></pre>
    2150. 

  2150.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L567" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2151. 

  2151. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L567" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2152. 

  2152. 

  2153.   </dd>
    2154. 

  2154. </div>
    2155. 

  2155. 

  2156. </div>
    2157. 

  2157. <div id="high-procs-all">
    2158. 

  2158.   <div id="high,typedesc[Duration]">
    2159. 

  2159.   <dt><pre><span class="Keyword">proc</span> <a href="#high%2Ctypedesc%5BDuration%5D"><span class="Identifier">high</span></a><span class="Other">(</span><span class="Identifier">typ</span><span class="Other">:</span> <a href="system.html#typedesc"><span class="Identifier">typedesc</span></a><span class="Other">[</span><a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a></pre></dt>
    2160. 

  2160.   <dd>
    2161. 

  2161.     
    2162. 

  2162.     Get the longest representable duration.
    2163. 

  2163.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L897" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2164. 

  2164. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L897" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2165. 

  2165. 

  2166.   </dd>
    2167. 

  2167. </div>
    2168. 

  2168. <div id="high,typedesc[Time]">
    2169. 

  2169.   <dt><pre><span class="Keyword">proc</span> <a href="#high%2Ctypedesc%5BTime%5D"><span class="Identifier">high</span></a><span class="Other">(</span><span class="Identifier">typ</span><span class="Other">:</span> <a href="system.html#typedesc"><span class="Identifier">typedesc</span></a><span class="Other">[</span><a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a></pre></dt>
    2170. 

  2170.   <dd>
    2171. 

  2171.     
    2172. 

  2172.     
    2173. 

  2173.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1042" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2174. 

  2174. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1042" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2175. 

  2175. 

  2176.   </dd>
    2177. 

  2177. </div>
    2178. 

  2178. 

  2179. </div>
    2180. 

  2180. <div id="hour-procs-all">
    2181. 

  2181.   <div id="hour,DateTime">
    2182. 

  2182.   <dt><pre><span class="Keyword">proc</span> <a href="#hour%2CDateTime"><span class="Identifier">hour</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#HourRange"><span class="Identifier">HourRange</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2183. 

  2183.   <dd>
    2184. 

  2184.     
    2185. 

  2185.     The number of hours past midnight, in the range 0 to 23.
    2186. 

  2186.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1073" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2187. 

  2187. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1073" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2188. 

  2188. 

  2189.   </dd>
    2190. 

  2190. </div>
    2191. 

  2191. 

  2192. </div>
    2193. 

  2193. <div id="hour=-procs-all">
    2194. 

  2194.   <div id="hour=,DateTime,HourRange">
    2195. 

  2195.   <dt><pre><span class="Keyword">proc</span> <a href="#hour%3D%2CDateTime%2CHourRange"><span class="Identifier">hour=</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">;</span> <span class="Identifier">value</span><span class="Other">:</span> <a href="times.html#HourRange"><span class="Identifier">HourRange</span></a><span class="Other">)</span> {.
    2196. 

  2196.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;Deprecated since v1.3.1&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2197. 

  2197.   <dd>
    2198. 

  2198.     <div class="deprecation-message">
    2199. 

  2199.   <b>Deprecated:</b> Deprecated since v1.3.1
    2200. 

  2200. </div>
    2201. 

  2201. 

  2202.     
    2203. 

  2203.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2872" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2204. 

  2204. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2872" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2205. 

  2205. 

  2206.   </dd>
    2207. 

  2207. </div>
    2208. 

  2208. 

  2209. </div>
    2210. 

  2210. <div id="hours-procs-all">
    2211. 

  2211.   <div id="hours,int">
    2212. 

  2212.   <dt><pre><span class="Keyword">proc</span> <a href="#hours%2Cint"><span class="Identifier">hours</span></a><span class="Other">(</span><span class="Identifier">h</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2213. 

  2213.   <dd>
    2214. 

  2214.     
    2215. 

  2215.     <p>TimeInterval of <tt class="docutils literal"><span class="pre"><span class="Identifier">h</span></span></tt> hours.</p>
    2216. 

  2216. <p><tt class="docutils literal"><span class="pre"><span class="Identifier">echo</span> <span class="Identifier">getTime</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">+</span> <span class="FloatNumber">2.</span><span class="Identifier">hours</span></span></tt></p>
    2217. 

  2217. 

  2218.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2610" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2219. 

  2219. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2610" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2220. 

  2220. 

  2221.   </dd>
    2222. 

  2222. </div>
    2223. 

  2223. 

  2224. </div>
    2225. 

  2225. <div id="inDays-procs-all">
    2226. 

  2226.   <div id="inDays,Duration">
    2227. 

  2227.   <dt><pre><span class="Keyword">proc</span> <a href="#inDays%2CDuration"><span class="Identifier">inDays</span></a><span class="Other">(</span><span class="Identifier">dur</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int64"><span class="Identifier">int64</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2228. 

  2228.   <dd>
    2229. 

  2229.     
    2230. 

  2230.     Converts the duration to the number of whole days.
    2231. 

  2231. <p><strong class="examples_text">Example:</strong></p>
    2232. 

  2232. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">dur</span> <span class="Operator">=</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">hours</span> <span class="Operator">=</span> <span class="Operator">-</span><span class="DecNumber">50</span><span class="Punctuation">)</span>
    2233. 

  2233. <span class="Identifier">doAssert</span> <span class="Identifier">dur</span><span class="Operator">.</span><span class="Identifier">inDays</span> <span class="Operator">==</span> <span class="Operator">-</span><span class="DecNumber">2</span></pre>
    2234. 

  2234.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L713" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2235. 

  2235. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L713" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2236. 

  2236. 

  2237.   </dd>
    2238. 

  2238. </div>
    2239. 

  2239. 

  2240. </div>
    2241. 

  2241. <div id="inHours-procs-all">
    2242. 

  2242.   <div id="inHours,Duration">
    2243. 

  2243.   <dt><pre><span class="Keyword">proc</span> <a href="#inHours%2CDuration"><span class="Identifier">inHours</span></a><span class="Other">(</span><span class="Identifier">dur</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int64"><span class="Identifier">int64</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2244. 

  2244.   <dd>
    2245. 

  2245.     
    2246. 

  2246.     Converts the duration to the number of whole hours.
    2247. 

  2247. <p><strong class="examples_text">Example:</strong></p>
    2248. 

  2248. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">dur</span> <span class="Operator">=</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">minutes</span> <span class="Operator">=</span> <span class="DecNumber">60</span><span class="Punctuation">,</span> <span class="Identifier">days</span> <span class="Operator">=</span> <span class="DecNumber">2</span><span class="Punctuation">)</span>
    2249. 

  2249. <span class="Identifier">doAssert</span> <span class="Identifier">dur</span><span class="Operator">.</span><span class="Identifier">inHours</span> <span class="Operator">==</span> <span class="DecNumber">49</span></pre>
    2250. 

  2250.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L720" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2251. 

  2251. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L720" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2252. 

  2252. 

  2253.   </dd>
    2254. 

  2254. </div>
    2255. 

  2255. 

  2256. </div>
    2257. 

  2257. <div id="initDateTime-procs-all">
    2258. 

  2258.   <div id="initDateTime,MonthdayRange,Month,int,HourRange,MinuteRange,SecondRange,NanosecondRange,Timezone">
    2259. 

  2259.   <dt><pre><span class="Keyword">proc</span> <a href="#initDateTime%2CMonthdayRange%2CMonth%2Cint%2CHourRange%2CMinuteRange%2CSecondRange%2CNanosecondRange%2CTimezone"><span class="Identifier">initDateTime</span></a><span class="Other">(</span><span class="Identifier">monthday</span><span class="Other">:</span> <a href="times.html#MonthdayRange"><span class="Identifier">MonthdayRange</span></a><span class="Other">;</span> <span class="Identifier">month</span><span class="Other">:</span> <a href="times.html#Month"><span class="Identifier">Month</span></a><span class="Other">;</span> <span class="Identifier">year</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">;</span>
    2260. 

  2260.                   <span class="Identifier">hour</span><span class="Other">:</span> <a href="times.html#HourRange"><span class="Identifier">HourRange</span></a><span class="Other">;</span> <span class="Identifier">minute</span><span class="Other">:</span> <a href="times.html#MinuteRange"><span class="Identifier">MinuteRange</span></a><span class="Other">;</span> <span class="Identifier">second</span><span class="Other">:</span> <a href="times.html#SecondRange"><span class="Identifier">SecondRange</span></a><span class="Other">;</span>
    2261. 

  2261.                   <span class="Identifier">nanosecond</span><span class="Other">:</span> <a href="times.html#NanosecondRange"><span class="Identifier">NanosecondRange</span></a><span class="Other">;</span> <span class="Identifier">zone</span><span class="Other">:</span> <a href="times.html#Timezone"><span class="Identifier">Timezone</span></a> <span class="Other">=</span> <span class="Identifier">local</span><span class="Other">(</span><span class="Other">)</span><span class="Other">)</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a> {.
    2262. 

  2262.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;use `dateTime`&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2263. 

  2263.   <dd>
    2264. 

  2264.     <div class="deprecation-message">
    2265. 

  2265.   <b>Deprecated:</b> use `dateTime`
    2266. 

  2266. </div>
    2267. 

  2267. 

  2268.     Create a new <a class="reference external" href="#DateTime">DateTime</a> in the specified timezone.
    2269. 

  2269. <p><strong class="examples_text">Example: cmd: --warning:deprecated:off</strong></p>
    2270. 

  2270. <pre class="listing"><span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">initDateTime</span><span class="Punctuation">(</span><span class="DecNumber">30</span><span class="Punctuation">,</span> <span class="Identifier">mMar</span><span class="Punctuation">,</span> <span class="DecNumber">2017</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;2017-03-30T00:00:00Z&quot;</span></pre>
    2271. 

  2271.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1439" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2272. 

  2272. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1439" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2273. 

  2273. 

  2274.   </dd>
    2275. 

  2275. </div>
    2276. 

  2276. <div id="initDateTime,MonthdayRange,Month,int,HourRange,MinuteRange,SecondRange,Timezone">
    2277. 

  2277.   <dt><pre><span class="Keyword">proc</span> <a href="#initDateTime%2CMonthdayRange%2CMonth%2Cint%2CHourRange%2CMinuteRange%2CSecondRange%2CTimezone"><span class="Identifier">initDateTime</span></a><span class="Other">(</span><span class="Identifier">monthday</span><span class="Other">:</span> <a href="times.html#MonthdayRange"><span class="Identifier">MonthdayRange</span></a><span class="Other">;</span> <span class="Identifier">month</span><span class="Other">:</span> <a href="times.html#Month"><span class="Identifier">Month</span></a><span class="Other">;</span> <span class="Identifier">year</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">;</span>
    2278. 

  2278.                   <span class="Identifier">hour</span><span class="Other">:</span> <a href="times.html#HourRange"><span class="Identifier">HourRange</span></a><span class="Other">;</span> <span class="Identifier">minute</span><span class="Other">:</span> <a href="times.html#MinuteRange"><span class="Identifier">MinuteRange</span></a><span class="Other">;</span> <span class="Identifier">second</span><span class="Other">:</span> <a href="times.html#SecondRange"><span class="Identifier">SecondRange</span></a><span class="Other">;</span>
    2279. 

  2279.                   <span class="Identifier">zone</span><span class="Other">:</span> <a href="times.html#Timezone"><span class="Identifier">Timezone</span></a> <span class="Other">=</span> <span class="Identifier">local</span><span class="Other">(</span><span class="Other">)</span><span class="Other">)</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a> {.
    2280. 

  2280.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;use `dateTime`&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2281. 

  2281.   <dd>
    2282. 

  2282.     <div class="deprecation-message">
    2283. 

  2283.   <b>Deprecated:</b> use `dateTime`
    2284. 

  2284. </div>
    2285. 

  2285. 

  2286.     Create a new <a class="reference external" href="#DateTime">DateTime</a> in the specified timezone.
    2287. 

  2287. <p><strong class="examples_text">Example: cmd: --warning:deprecated:off</strong></p>
    2288. 

  2288. <pre class="listing"><span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">initDateTime</span><span class="Punctuation">(</span><span class="DecNumber">30</span><span class="Punctuation">,</span> <span class="Identifier">mMar</span><span class="Punctuation">,</span> <span class="DecNumber">2017</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;2017-03-30T00:00:00Z&quot;</span></pre>
    2289. 

  2289.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1448" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2290. 

  2290. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1448" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2291. 

  2291. 

  2292.   </dd>
    2293. 

  2293. </div>
    2294. 

  2294. <div id="initDateTime,WeekDay,IsoWeekRange,IsoYear,HourRange,MinuteRange,SecondRange,NanosecondRange,Timezone">
    2295. 

  2295.   <dt><pre><span class="Keyword">proc</span> <a href="#initDateTime%2CWeekDay%2CIsoWeekRange%2CIsoYear%2CHourRange%2CMinuteRange%2CSecondRange%2CNanosecondRange%2CTimezone"><span class="Identifier">initDateTime</span></a><span class="Other">(</span><span class="Identifier">weekday</span><span class="Other">:</span> <a href="times.html#WeekDay"><span class="Identifier">WeekDay</span></a><span class="Other">;</span> <span class="Identifier">isoweek</span><span class="Other">:</span> <a href="times.html#IsoWeekRange"><span class="Identifier">IsoWeekRange</span></a><span class="Other">;</span> <span class="Identifier">isoyear</span><span class="Other">:</span> <a href="times.html#IsoYear"><span class="Identifier">IsoYear</span></a><span class="Other">;</span>
    2296. 

  2296.                   <span class="Identifier">hour</span><span class="Other">:</span> <a href="times.html#HourRange"><span class="Identifier">HourRange</span></a><span class="Other">;</span> <span class="Identifier">minute</span><span class="Other">:</span> <a href="times.html#MinuteRange"><span class="Identifier">MinuteRange</span></a><span class="Other">;</span> <span class="Identifier">second</span><span class="Other">:</span> <a href="times.html#SecondRange"><span class="Identifier">SecondRange</span></a><span class="Other">;</span>
    2297. 

  2297.                   <span class="Identifier">nanosecond</span><span class="Other">:</span> <a href="times.html#NanosecondRange"><span class="Identifier">NanosecondRange</span></a><span class="Other">;</span> <span class="Identifier">zone</span><span class="Other">:</span> <a href="times.html#Timezone"><span class="Identifier">Timezone</span></a> <span class="Other">=</span> <span class="Identifier">local</span><span class="Other">(</span><span class="Other">)</span><span class="Other">)</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a> {.
    2298. 

  2298.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2299. 

  2299.   <dd>
    2300. 

  2300.     
    2301. 

  2301.     
    2302. 

  2302.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1531" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2303. 

  2303. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1531" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2304. 

  2304. 

  2305.   </dd>
    2306. 

  2306. </div>
    2307. 

  2307. <div id="initDateTime,WeekDay,IsoWeekRange,IsoYear,HourRange,MinuteRange,SecondRange,Timezone">
    2308. 

  2308.   <dt><pre><span class="Keyword">proc</span> <a href="#initDateTime%2CWeekDay%2CIsoWeekRange%2CIsoYear%2CHourRange%2CMinuteRange%2CSecondRange%2CTimezone"><span class="Identifier">initDateTime</span></a><span class="Other">(</span><span class="Identifier">weekday</span><span class="Other">:</span> <a href="times.html#WeekDay"><span class="Identifier">WeekDay</span></a><span class="Other">;</span> <span class="Identifier">isoweek</span><span class="Other">:</span> <a href="times.html#IsoWeekRange"><span class="Identifier">IsoWeekRange</span></a><span class="Other">;</span> <span class="Identifier">isoyear</span><span class="Other">:</span> <a href="times.html#IsoYear"><span class="Identifier">IsoYear</span></a><span class="Other">;</span>
    2309. 

  2309.                   <span class="Identifier">hour</span><span class="Other">:</span> <a href="times.html#HourRange"><span class="Identifier">HourRange</span></a><span class="Other">;</span> <span class="Identifier">minute</span><span class="Other">:</span> <a href="times.html#MinuteRange"><span class="Identifier">MinuteRange</span></a><span class="Other">;</span> <span class="Identifier">second</span><span class="Other">:</span> <a href="times.html#SecondRange"><span class="Identifier">SecondRange</span></a><span class="Other">;</span>
    2310. 

  2310.                   <span class="Identifier">zone</span><span class="Other">:</span> <a href="times.html#Timezone"><span class="Identifier">Timezone</span></a> <span class="Other">=</span> <span class="Identifier">local</span><span class="Other">(</span><span class="Other">)</span><span class="Other">)</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    2311. 

  2311.     <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2312. 

  2312.   <dd>
    2313. 

  2313.     
    2314. 

  2314.     
    2315. 

  2315.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1536" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2316. 

  2316. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1536" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2317. 

  2317. 

  2318.   </dd>
    2319. 

  2319. </div>
    2320. 

  2320. 

  2321. </div>
    2322. 

  2322. <div id="initDuration-procs-all">
    2323. 

  2323.   <div id="initDuration,int64,int64,int64,int64,int64,int64,int64,int64">
    2324. 

  2324.   <dt><pre><span class="Keyword">proc</span> <a href="#initDuration%2Cint64%2Cint64%2Cint64%2Cint64%2Cint64%2Cint64%2Cint64%2Cint64"><span class="Identifier">initDuration</span></a><span class="Other">(</span><span class="Identifier">nanoseconds</span><span class="Other">,</span> <span class="Identifier">microseconds</span><span class="Other">,</span> <span class="Identifier">milliseconds</span><span class="Other">,</span> <span class="Identifier">seconds</span><span class="Other">,</span> <span class="Identifier">minutes</span><span class="Other">,</span>
    2325. 

  2325.                   <span class="Identifier">hours</span><span class="Other">,</span> <span class="Identifier">days</span><span class="Other">,</span> <span class="Identifier">weeks</span><span class="Other">:</span> <a href="system.html#int64"><span class="Identifier">int64</span></a> <span class="Other">=</span> <span class="DecNumber">0</span><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    2326. 

  2326.     <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2327. 

  2327.   <dd>
    2328. 

  2328.     
    2329. 

  2329.     Create a new <a class="reference external" href="#Duration">Duration</a>.
    2330. 

  2330. <p><strong class="examples_text">Example:</strong></p>
    2331. 

  2331. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">dur</span> <span class="Operator">=</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">,</span> <span class="Identifier">milliseconds</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">)</span>
    2332. 

  2332. <span class="Identifier">doAssert</span> <span class="Identifier">dur</span><span class="Operator">.</span><span class="Identifier">inMilliseconds</span> <span class="Operator">==</span> <span class="DecNumber">1001</span>
    2333. 

  2333. <span class="Identifier">doAssert</span> <span class="Identifier">dur</span><span class="Operator">.</span><span class="Identifier">inSeconds</span> <span class="Operator">==</span> <span class="DecNumber">1</span></pre>
    2334. 

  2334.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L665" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2335. 

  2335. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L665" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2336. 

  2336. 

  2337.   </dd>
    2338. 

  2338. </div>
    2339. 

  2339. 

  2340. </div>
    2341. 

  2341. <div id="initTime-procs-all">
    2342. 

  2342.   <div id="initTime,int64,NanosecondRange">
    2343. 

  2343.   <dt><pre><span class="Keyword">proc</span> <a href="#initTime%2Cint64%2CNanosecondRange"><span class="Identifier">initTime</span></a><span class="Other">(</span><span class="Identifier">unix</span><span class="Other">:</span> <a href="system.html#int64"><span class="Identifier">int64</span></a><span class="Other">;</span> <span class="Identifier">nanosecond</span><span class="Other">:</span> <a href="times.html#NanosecondRange"><span class="Identifier">NanosecondRange</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    2344. 

  2344.     <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2345. 

  2345.   <dd>
    2346. 

  2346.     
    2347. 

  2347.     Create a <a class="reference external" href="#Time">Time</a> from a unix timestamp and a nanosecond part.
    2348. 

  2348.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L915" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2349. 

  2349. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L915" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2350. 

  2350. 

  2351.   </dd>
    2352. 

  2352. </div>
    2353. 

  2353. 

  2354. </div>
    2355. 

  2355. <div id="initTimeFormat-procs-all">
    2356. 

  2356.   <div id="initTimeFormat,string">
    2357. 

  2357.   <dt><pre><span class="Keyword">proc</span> <a href="#initTimeFormat%2Cstring"><span class="Identifier">initTimeFormat</span></a><span class="Other">(</span><span class="Identifier">format</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#TimeFormat"><span class="Identifier">TimeFormat</span></a> {.
    2358. 

  2358.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">TimeFormatParseError</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2359. 

  2359.   <dd>
    2360. 

  2360.     
    2361. 

  2361.     <p>Construct a new time format for parsing &amp; formatting time types.</p>
    2362. 

  2362. <p>See <a class="reference internal" href="#parsing-and-formatting-dates">Parsing and formatting dates</a> for documentation of the <tt class="docutils literal"><span class="pre"><span class="Identifier">format</span></span></tt> argument.</p>
    2363. 

  2363. 

  2364. <p><strong class="examples_text">Example:</strong></p>
    2365. 

  2365. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">f</span> <span class="Operator">=</span> <span class="Identifier">initTimeFormat</span><span class="Punctuation">(</span><span class="StringLit">&quot;yyyy-MM-dd&quot;</span><span class="Punctuation">)</span>
    2366. 

  2366. <span class="Identifier">doAssert</span> <span class="StringLit">&quot;2000-01-01&quot;</span> <span class="Operator">==</span> <span class="StringLit">&quot;2000-01-01&quot;</span><span class="Operator">.</span><span class="Identifier">parse</span><span class="Punctuation">(</span><span class="Identifier">f</span><span class="Punctuation">)</span><span class="Operator">.</span><span class="Identifier">format</span><span class="Punctuation">(</span><span class="Identifier">f</span><span class="Punctuation">)</span></pre>
    2367. 

  2367.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1764" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2368. 

  2368. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1764" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2369. 

  2369. 

  2370.   </dd>
    2371. 

  2371. </div>
    2372. 

  2372. 

  2373. </div>
    2374. 

  2374. <div id="initTimeInterval-procs-all">
    2375. 

  2375.   <div id="initTimeInterval,int,int,int,int,int,int,int,int,int,int">
    2376. 

  2376.   <dt><pre><span class="Keyword">proc</span> <a href="#initTimeInterval%2Cint%2Cint%2Cint%2Cint%2Cint%2Cint%2Cint%2Cint%2Cint%2Cint"><span class="Identifier">initTimeInterval</span></a><span class="Other">(</span><span class="Identifier">nanoseconds</span> <span class="Other">=</span> <span class="DecNumber">0</span><span class="Other">;</span> <span class="Identifier">microseconds</span> <span class="Other">=</span> <span class="DecNumber">0</span><span class="Other">;</span> <span class="Identifier">milliseconds</span> <span class="Other">=</span> <span class="DecNumber">0</span><span class="Other">;</span>
    2377. 

  2377.                       <span class="Identifier">seconds</span> <span class="Other">=</span> <span class="DecNumber">0</span><span class="Other">;</span> <span class="Identifier">minutes</span> <span class="Other">=</span> <span class="DecNumber">0</span><span class="Other">;</span> <span class="Identifier">hours</span> <span class="Other">=</span> <span class="DecNumber">0</span><span class="Other">;</span> <span class="Identifier">days</span> <span class="Other">=</span> <span class="DecNumber">0</span><span class="Other">;</span> <span class="Identifier">weeks</span> <span class="Other">=</span> <span class="DecNumber">0</span><span class="Other">;</span>
    2378. 

  2378.                       <span class="Identifier">months</span> <span class="Other">=</span> <span class="DecNumber">0</span><span class="Other">;</span> <span class="Identifier">years</span> <span class="Other">=</span> <span class="DecNumber">0</span><span class="Other">)</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    2379. 

  2379.     <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2380. 

  2380.   <dd>
    2381. 

  2381.     
    2382. 

  2382.     <p>Creates a new <a class="reference external" href="#TimeInterval">TimeInterval</a>.</p>
    2383. 

  2383. <p>This proc doesn't perform any normalization! For example, <tt class="docutils literal"><span class="pre"><span class="Identifier">initTimeInterval</span><span class="Punctuation">(</span><span class="Identifier">hours</span> <span class="Operator">=</span> <span class="DecNumber">24</span><span class="Punctuation">)</span></span></tt> and <tt class="docutils literal"><span class="pre"><span class="Identifier">initTimeInterval</span><span class="Punctuation">(</span><span class="Identifier">days</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">)</span></span></tt> are not equal.</p>
    2384. 

  2384. <p>You can also use the convenience procedures called <tt class="docutils literal"><span class="pre"><span class="Identifier">milliseconds</span></span></tt>, <tt class="docutils literal"><span class="pre"><span class="Identifier">seconds</span></span></tt>, <tt class="docutils literal"><span class="pre"><span class="Identifier">minutes</span></span></tt>, <tt class="docutils literal"><span class="pre"><span class="Identifier">hours</span></span></tt>, <tt class="docutils literal"><span class="pre"><span class="Identifier">days</span></span></tt>, <tt class="docutils literal"><span class="pre"><span class="Identifier">months</span></span></tt>, and <tt class="docutils literal"><span class="pre"><span class="Identifier">years</span></span></tt>.</p>
    2385. 

  2385. 

  2386. <p><strong class="examples_text">Example:</strong></p>
    2387. 

  2387. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">day</span> <span class="Operator">=</span> <span class="Identifier">initTimeInterval</span><span class="Punctuation">(</span><span class="Identifier">hours</span> <span class="Operator">=</span> <span class="DecNumber">24</span><span class="Punctuation">)</span>
    2388. 

  2388. <span class="Keyword">let</span> <span class="Identifier">dt</span> <span class="Operator">=</span> <span class="Identifier">dateTime</span><span class="Punctuation">(</span><span class="DecNumber">2000</span><span class="Punctuation">,</span> <span class="Identifier">mJan</span><span class="Punctuation">,</span> <span class="DecNumber">01</span><span class="Punctuation">,</span> <span class="DecNumber">12</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
    2389. 

  2389. <span class="Identifier">doAssert</span> <span class="Operator">$</span><span class="Punctuation">(</span><span class="Identifier">dt</span> <span class="Operator">+</span> <span class="Identifier">day</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;2000-01-02T12:00:00Z&quot;</span>
    2390. 

  2390. <span class="Identifier">doAssert</span> <span class="Identifier">initTimeInterval</span><span class="Punctuation">(</span><span class="Identifier">hours</span> <span class="Operator">=</span> <span class="DecNumber">24</span><span class="Punctuation">)</span> <span class="Operator">!=</span> <span class="Identifier">initTimeInterval</span><span class="Punctuation">(</span><span class="Identifier">days</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">)</span></pre>
    2391. 

  2391.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2356" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2392. 

  2392. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2356" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2393. 

  2393. 

  2394.   </dd>
    2395. 

  2395. </div>
    2396. 

  2396. 

  2397. </div>
    2398. 

  2398. <div id="inMicroseconds-procs-all">
    2399. 

  2399.   <div id="inMicroseconds,Duration">
    2400. 

  2400.   <dt><pre><span class="Keyword">proc</span> <a href="#inMicroseconds%2CDuration"><span class="Identifier">inMicroseconds</span></a><span class="Other">(</span><span class="Identifier">dur</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int64"><span class="Identifier">int64</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2401. 

  2401.   <dd>
    2402. 

  2402.     
    2403. 

  2403.     Converts the duration to the number of whole microseconds.
    2404. 

  2404. <p><strong class="examples_text">Example:</strong></p>
    2405. 

  2405. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">dur</span> <span class="Operator">=</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="Operator">-</span><span class="DecNumber">2</span><span class="Punctuation">)</span>
    2406. 

  2406. <span class="Identifier">doAssert</span> <span class="Identifier">dur</span><span class="Operator">.</span><span class="Identifier">inMicroseconds</span> <span class="Operator">==</span> <span class="Operator">-</span><span class="DecNumber">2000000</span></pre>
    2407. 

  2407.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L748" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2408. 

  2408. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L748" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2409. 

  2409. 

  2410.   </dd>
    2411. 

  2411. </div>
    2412. 

  2412. 

  2413. </div>
    2414. 

  2414. <div id="inMilliseconds-procs-all">
    2415. 

  2415.   <div id="inMilliseconds,Duration">
    2416. 

  2416.   <dt><pre><span class="Keyword">proc</span> <a href="#inMilliseconds%2CDuration"><span class="Identifier">inMilliseconds</span></a><span class="Other">(</span><span class="Identifier">dur</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int64"><span class="Identifier">int64</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2417. 

  2417.   <dd>
    2418. 

  2418.     
    2419. 

  2419.     Converts the duration to the number of whole milliseconds.
    2420. 

  2420. <p><strong class="examples_text">Example:</strong></p>
    2421. 

  2421. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">dur</span> <span class="Operator">=</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="Operator">-</span><span class="DecNumber">2</span><span class="Punctuation">)</span>
    2422. 

  2422. <span class="Identifier">doAssert</span> <span class="Identifier">dur</span><span class="Operator">.</span><span class="Identifier">inMilliseconds</span> <span class="Operator">==</span> <span class="Operator">-</span><span class="DecNumber">2000</span></pre>
    2423. 

  2423.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L741" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2424. 

  2424. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L741" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2425. 

  2425. 

  2426.   </dd>
    2427. 

  2427. </div>
    2428. 

  2428. 

  2429. </div>
    2430. 

  2430. <div id="inMinutes-procs-all">
    2431. 

  2431.   <div id="inMinutes,Duration">
    2432. 

  2432.   <dt><pre><span class="Keyword">proc</span> <a href="#inMinutes%2CDuration"><span class="Identifier">inMinutes</span></a><span class="Other">(</span><span class="Identifier">dur</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int64"><span class="Identifier">int64</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2433. 

  2433.   <dd>
    2434. 

  2434.     
    2435. 

  2435.     Converts the duration to the number of whole minutes.
    2436. 

  2436. <p><strong class="examples_text">Example:</strong></p>
    2437. 

  2437. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">dur</span> <span class="Operator">=</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">hours</span> <span class="Operator">=</span> <span class="DecNumber">2</span><span class="Punctuation">,</span> <span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="DecNumber">10</span><span class="Punctuation">)</span>
    2438. 

  2438. <span class="Identifier">doAssert</span> <span class="Identifier">dur</span><span class="Operator">.</span><span class="Identifier">inMinutes</span> <span class="Operator">==</span> <span class="DecNumber">120</span></pre>
    2439. 

  2439.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L727" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2440. 

  2440. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L727" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2441. 

  2441. 

  2442.   </dd>
    2443. 

  2443. </div>
    2444. 

  2444. 

  2445. </div>
    2446. 

  2446. <div id="inNanoseconds-procs-all">
    2447. 

  2447.   <div id="inNanoseconds,Duration">
    2448. 

  2448.   <dt><pre><span class="Keyword">proc</span> <a href="#inNanoseconds%2CDuration"><span class="Identifier">inNanoseconds</span></a><span class="Other">(</span><span class="Identifier">dur</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int64"><span class="Identifier">int64</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2449. 

  2449.   <dd>
    2450. 

  2450.     
    2451. 

  2451.     Converts the duration to the number of whole nanoseconds.
    2452. 

  2452. <p><strong class="examples_text">Example:</strong></p>
    2453. 

  2453. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">dur</span> <span class="Operator">=</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">seconds</span> <span class="Operator">=</span> <span class="Operator">-</span><span class="DecNumber">2</span><span class="Punctuation">)</span>
    2454. 

  2454. <span class="Identifier">doAssert</span> <span class="Identifier">dur</span><span class="Operator">.</span><span class="Identifier">inNanoseconds</span> <span class="Operator">==</span> <span class="Operator">-</span><span class="DecNumber">2000000000</span></pre>
    2455. 

  2455.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L755" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2456. 

  2456. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L755" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2457. 

  2457. 

  2458.   </dd>
    2459. 

  2459. </div>
    2460. 

  2460. 

  2461. </div>
    2462. 

  2462. <div id="inSeconds-procs-all">
    2463. 

  2463.   <div id="inSeconds,Duration">
    2464. 

  2464.   <dt><pre><span class="Keyword">proc</span> <a href="#inSeconds%2CDuration"><span class="Identifier">inSeconds</span></a><span class="Other">(</span><span class="Identifier">dur</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int64"><span class="Identifier">int64</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2465. 

  2465.   <dd>
    2466. 

  2466.     
    2467. 

  2467.     Converts the duration to the number of whole seconds.
    2468. 

  2468. <p><strong class="examples_text">Example:</strong></p>
    2469. 

  2469. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">dur</span> <span class="Operator">=</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">hours</span> <span class="Operator">=</span> <span class="DecNumber">2</span><span class="Punctuation">,</span> <span class="Identifier">milliseconds</span> <span class="Operator">=</span> <span class="DecNumber">10</span><span class="Punctuation">)</span>
    2470. 

  2470. <span class="Identifier">doAssert</span> <span class="Identifier">dur</span><span class="Operator">.</span><span class="Identifier">inSeconds</span> <span class="Operator">==</span> <span class="DecNumber">2</span> <span class="Operator">*</span> <span class="DecNumber">60</span> <span class="Operator">*</span> <span class="DecNumber">60</span></pre>
    2471. 

  2471.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L734" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2472. 

  2472. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L734" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2473. 

  2473. 

  2474.   </dd>
    2475. 

  2475. </div>
    2476. 

  2476. 

  2477. </div>
    2478. 

  2478. <div id="inWeeks-procs-all">
    2479. 

  2479.   <div id="inWeeks,Duration">
    2480. 

  2480.   <dt><pre><span class="Keyword">proc</span> <a href="#inWeeks%2CDuration"><span class="Identifier">inWeeks</span></a><span class="Other">(</span><span class="Identifier">dur</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int64"><span class="Identifier">int64</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2481. 

  2481.   <dd>
    2482. 

  2482.     
    2483. 

  2483.     Converts the duration to the number of whole weeks.
    2484. 

  2484. <p><strong class="examples_text">Example:</strong></p>
    2485. 

  2485. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">dur</span> <span class="Operator">=</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">days</span> <span class="Operator">=</span> <span class="DecNumber">8</span><span class="Punctuation">)</span>
    2486. 

  2486. <span class="Identifier">doAssert</span> <span class="Identifier">dur</span><span class="Operator">.</span><span class="Identifier">inWeeks</span> <span class="Operator">==</span> <span class="DecNumber">1</span></pre>
    2487. 

  2487.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L706" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2488. 

  2488. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L706" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2489. 

  2489. 

  2490.   </dd>
    2491. 

  2491. </div>
    2492. 

  2492. 

  2493. </div>
    2494. 

  2494. <div id="inZone-procs-all">
    2495. 

  2495.   <div id="inZone,DateTime,Timezone">
    2496. 

  2496.   <dt><pre><span class="Keyword">proc</span> <a href="#inZone%2CDateTime%2CTimezone"><span class="Identifier">inZone</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">;</span> <span class="Identifier">zone</span><span class="Other">:</span> <a href="times.html#Timezone"><span class="Identifier">Timezone</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    2497. 

  2497.     <span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2498. 

  2498.   <dd>
    2499. 

  2499.     
    2500. 

  2500.     Returns a <tt class="docutils literal"><span class="pre"><span class="Identifier">DateTime</span></span></tt> representing the same point in time as <tt class="docutils literal"><span class="pre"><span class="Identifier">dt</span></span></tt> but using <tt class="docutils literal"><span class="pre"><span class="Identifier">zone</span></span></tt> as the timezone.
    2501. 

  2501.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1270" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2502. 

  2502. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1270" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2503. 

  2503. 

  2504.   </dd>
    2505. 

  2505. </div>
    2506. 

  2506. <div id="inZone,Time,Timezone">
    2507. 

  2507.   <dt><pre><span class="Keyword">proc</span> <a href="#inZone%2CTime%2CTimezone"><span class="Identifier">inZone</span></a><span class="Other">(</span><span class="Identifier">time</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">;</span> <span class="Identifier">zone</span><span class="Other">:</span> <a href="times.html#Timezone"><span class="Identifier">Timezone</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    2508. 

  2508.     <span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2509. 

  2509.   <dd>
    2510. 

  2510.     
    2511. 

  2511.     Convert <tt class="docutils literal"><span class="pre"><span class="Identifier">time</span></span></tt> into a <tt class="docutils literal"><span class="pre"><span class="Identifier">DateTime</span></span></tt> using <tt class="docutils literal"><span class="pre"><span class="Identifier">zone</span></span></tt> as the timezone.
    2512. 

  2512.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1265" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2513. 

  2513. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1265" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2514. 

  2514. 

  2515.   </dd>
    2516. 

  2516. </div>
    2517. 

  2517. 

  2518. </div>
    2519. 

  2519. <div id="isDst-procs-all">
    2520. 

  2520.   <div id="isDst,DateTime">
    2521. 

  2521.   <dt><pre><span class="Keyword">proc</span> <a href="#isDst%2CDateTime"><span class="Identifier">isDst</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2522. 

  2522.   <dd>
    2523. 

  2523.     
    2524. 

  2524.     Determines whether DST is in effect. Always false for the JavaScript backend.
    2525. 

  2525.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1111" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2526. 

  2526. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1111" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2527. 

  2527. 

  2528.   </dd>
    2529. 

  2529. </div>
    2530. 

  2530. 

  2531. </div>
    2532. 

  2532. <div id="isDst=-procs-all">
    2533. 

  2533.   <div id="isDst=,DateTime,bool">
    2534. 

  2534.   <dt><pre><span class="Keyword">proc</span> <a href="#isDst%3D%2CDateTime%2Cbool"><span class="Identifier">isDst=</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">;</span> <span class="Identifier">value</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a><span class="Other">)</span> {.
    2535. 

  2535.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;Deprecated since v1.3.1&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2536. 

  2536.   <dd>
    2537. 

  2537.     <div class="deprecation-message">
    2538. 

  2538.   <b>Deprecated:</b> Deprecated since v1.3.1
    2539. 

  2539. </div>
    2540. 

  2540. 

  2541.     
    2542. 

  2542.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2890" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2543. 

  2543. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2890" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2544. 

  2544. 

  2545.   </dd>
    2546. 

  2546. </div>
    2547. 

  2547. 

  2548. </div>
    2549. 

  2549. <div id="isInitialized-procs-all">
    2550. 

  2550.   <div id="isInitialized,DateTime">
    2551. 

  2551.   <dt><pre><span class="Keyword">proc</span> <a href="#isInitialized%2CDateTime"><span class="Identifier">isInitialized</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2552. 

  2552.   <dd>
    2553. 

  2553.     
    2554. 

  2554.     
    2555. 

  2555. <p><strong class="examples_text">Example:</strong></p>
    2556. 

  2556. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">now</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Operator">.</span><span class="Identifier">isInitialized</span>
    2557. 

  2557. <span class="Identifier">doAssert</span> <span class="Keyword">not</span> <span class="Identifier">default</span><span class="Punctuation">(</span><span class="Identifier">DateTime</span><span class="Punctuation">)</span><span class="Operator">.</span><span class="Identifier">isInitialized</span></pre>
    2558. 

  2558.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1133" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2559. 

  2559. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1133" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2560. 

  2560. 

  2561.   </dd>
    2562. 

  2562. </div>
    2563. 

  2563. 

  2564. </div>
    2565. 

  2565. <div id="isLeapDay-procs-all">
    2566. 

  2566.   <div id="isLeapDay,DateTime">
    2567. 

  2567.   <dt><pre><span class="Keyword">proc</span> <a href="#isLeapDay%2CDateTime"><span class="Identifier">isLeapDay</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2568. 

  2568.   <dd>
    2569. 

  2569.     
    2570. 

  2570.     Returns whether <tt class="docutils literal"><span class="pre"><span class="Identifier">t</span></span></tt> is a leap day, i.e. Feb 29 in a leap year. This matters as it affects time offset calculations.
    2571. 

  2571. <p><strong class="examples_text">Example:</strong></p>
    2572. 

  2572. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">dt</span> <span class="Operator">=</span> <span class="Identifier">dateTime</span><span class="Punctuation">(</span><span class="DecNumber">2020</span><span class="Punctuation">,</span> <span class="Identifier">mFeb</span><span class="Punctuation">,</span> <span class="DecNumber">29</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
    2573. 

  2573. <span class="Identifier">doAssert</span> <span class="Identifier">dt</span><span class="Operator">.</span><span class="Identifier">isLeapDay</span>
    2574. 

  2574. <span class="Identifier">doAssert</span> <span class="Identifier">dt</span><span class="Operator">+</span><span class="FloatNumber">1.</span><span class="Identifier">years</span><span class="Operator">-</span><span class="FloatNumber">1.</span><span class="Identifier">years</span> <span class="Operator">!=</span> <span class="Identifier">dt</span>
    2575. 

  2575. <span class="Keyword">let</span> <span class="Identifier">dt2</span> <span class="Operator">=</span> <span class="Identifier">dateTime</span><span class="Punctuation">(</span><span class="DecNumber">2020</span><span class="Punctuation">,</span> <span class="Identifier">mFeb</span><span class="Punctuation">,</span> <span class="DecNumber">28</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
    2576. 

  2576. <span class="Identifier">doAssert</span> <span class="Keyword">not</span> <span class="Identifier">dt2</span><span class="Operator">.</span><span class="Identifier">isLeapDay</span>
    2577. 

  2577. <span class="Identifier">doAssert</span> <span class="Identifier">dt2</span><span class="Operator">+</span><span class="FloatNumber">1.</span><span class="Identifier">years</span><span class="Operator">-</span><span class="FloatNumber">1.</span><span class="Identifier">years</span> <span class="Operator">==</span> <span class="Identifier">dt2</span>
    2578. 

  2578. <span class="Identifier">doAssertRaises</span><span class="Punctuation">(</span><span class="Identifier">Exception</span><span class="Punctuation">)</span><span class="Punctuation">:</span> <span class="Keyword">discard</span> <span class="Identifier">dateTime</span><span class="Punctuation">(</span><span class="DecNumber">2021</span><span class="Punctuation">,</span> <span class="Identifier">mFeb</span><span class="Punctuation">,</span> <span class="DecNumber">29</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre>
    2579. 

  2579.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1143" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2580. 

  2580. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1143" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2581. 

  2581. 

  2582.   </dd>
    2583. 

  2583. </div>
    2584. 

  2584. 

  2585. </div>
    2586. 

  2586. <div id="isLeapYear-procs-all">
    2587. 

  2587.   <div id="isLeapYear,int">
    2588. 

  2588.   <dt><pre><span class="Keyword">proc</span> <a href="#isLeapYear%2Cint"><span class="Identifier">isLeapYear</span></a><span class="Other">(</span><span class="Identifier">year</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#bool"><span class="Identifier">bool</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2589. 

  2589.   <dd>
    2590. 

  2590.     
    2591. 

  2591.     Returns true if <tt class="docutils literal"><span class="pre"><span class="Identifier">year</span></span></tt> is a leap year.
    2592. 

  2592. <p><strong class="examples_text">Example:</strong></p>
    2593. 

  2593. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">isLeapYear</span><span class="Punctuation">(</span><span class="DecNumber">2000</span><span class="Punctuation">)</span>
    2594. 

  2594. <span class="Identifier">doAssert</span> <span class="Keyword">not</span> <span class="Identifier">isLeapYear</span><span class="Punctuation">(</span><span class="DecNumber">1900</span><span class="Punctuation">)</span></pre>
    2595. 

  2595.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L462" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2596. 

  2596. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L462" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2597. 

  2597. 

  2598.   </dd>
    2599. 

  2599. </div>
    2600. 

  2600. 

  2601. </div>
    2602. 

  2602. <div id="local-procs-all">
    2603. 

  2603.   <div id="local">
    2604. 

  2604.   <dt><pre><span class="Keyword">proc</span> <a href="#local"><span class="Identifier">local</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Timezone"><span class="Identifier">Timezone</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2605. 

  2605.   <dd>
    2606. 

  2606.     
    2607. 

  2607.     Get the <tt class="docutils literal"><span class="pre"><span class="Identifier">Timezone</span></span></tt> implementation for the local timezone.
    2608. 

  2608. <p><strong class="examples_text">Example:</strong></p>
    2609. 

  2609. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">now</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Operator">.</span><span class="Identifier">timezone</span> <span class="Operator">==</span> <span class="Identifier">local</span><span class="Punctuation">(</span><span class="Punctuation">)</span>
    2610. 

  2610. <span class="Identifier">doAssert</span> <span class="Identifier">local</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Operator">.</span><span class="Identifier">name</span> <span class="Operator">==</span> <span class="StringLit">&quot;LOCAL&quot;</span></pre>
    2611. 

  2611.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1385" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2612. 

  2612. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1385" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2613. 

  2613. 

  2614.   </dd>
    2615. 

  2615. </div>
    2616. 

  2616. <div id="local,DateTime">
    2617. 

  2617.   <dt><pre><span class="Keyword">proc</span> <a href="#local%2CDateTime"><span class="Identifier">local</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2618. 

  2618.   <dd>
    2619. 

  2619.     
    2620. 

  2620.     Shorthand for <tt class="docutils literal"><span class="pre"><span class="Identifier">dt</span><span class="Operator">.</span><span class="Identifier">inZone</span><span class="Punctuation">(</span><span class="Identifier">local</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span></span></tt>.
    2621. 

  2621.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1399" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2622. 

  2622. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1399" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2623. 

  2623. 

  2624.   </dd>
    2625. 

  2625. </div>
    2626. 

  2626. <div id="local,Time">
    2627. 

  2627.   <dt><pre><span class="Keyword">proc</span> <a href="#local%2CTime"><span class="Identifier">local</span></a><span class="Other">(</span><span class="Identifier">t</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2628. 

  2628.   <dd>
    2629. 

  2629.     
    2630. 

  2630.     Shorthand for <tt class="docutils literal"><span class="pre"><span class="Identifier">t</span><span class="Operator">.</span><span class="Identifier">inZone</span><span class="Punctuation">(</span><span class="Identifier">local</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span></span></tt>.
    2631. 

  2631.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1407" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2632. 

  2632. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1407" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2633. 

  2633. 

  2634.   </dd>
    2635. 

  2635. </div>
    2636. 

  2636. 

  2637. </div>
    2638. 

  2638. <div id="low-procs-all">
    2639. 

  2639.   <div id="low,typedesc[Duration]">
    2640. 

  2640.   <dt><pre><span class="Keyword">proc</span> <a href="#low%2Ctypedesc%5BDuration%5D"><span class="Identifier">low</span></a><span class="Other">(</span><span class="Identifier">typ</span><span class="Other">:</span> <a href="system.html#typedesc"><span class="Identifier">typedesc</span></a><span class="Other">[</span><a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a></pre></dt>
    2641. 

  2641.   <dd>
    2642. 

  2642.     
    2643. 

  2643.     Get the longest representable duration of negative direction.
    2644. 

  2644.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L901" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2645. 

  2645. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L901" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2646. 

  2646. 

  2647.   </dd>
    2648. 

  2648. </div>
    2649. 

  2649. <div id="low,typedesc[Time]">
    2650. 

  2650.   <dt><pre><span class="Keyword">proc</span> <a href="#low%2Ctypedesc%5BTime%5D"><span class="Identifier">low</span></a><span class="Other">(</span><span class="Identifier">typ</span><span class="Other">:</span> <a href="system.html#typedesc"><span class="Identifier">typedesc</span></a><span class="Other">[</span><a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a></pre></dt>
    2651. 

  2651.   <dd>
    2652. 

  2652.     
    2653. 

  2653.     
    2654. 

  2654.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1045" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2655. 

  2655. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1045" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2656. 

  2656. 

  2657.   </dd>
    2658. 

  2658. </div>
    2659. 

  2659. 

  2660. </div>
    2661. 

  2661. <div id="microseconds-procs-all">
    2662. 

  2662.   <div id="microseconds,int">
    2663. 

  2663.   <dt><pre><span class="Keyword">proc</span> <a href="#microseconds%2Cint"><span class="Identifier">microseconds</span></a><span class="Other">(</span><span class="Identifier">micros</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    2664. 

  2664.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2665. 

  2665.   <dd>
    2666. 

  2666.     
    2667. 

  2667.     TimeInterval of <tt class="docutils literal"><span class="pre"><span class="Identifier">micros</span></span></tt> microseconds.
    2668. 

  2668.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2590" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2669. 

  2669. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2590" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2670. 

  2670. 

  2671.   </dd>
    2672. 

  2672. </div>
    2673. 

  2673. 

  2674. </div>
    2675. 

  2675. <div id="milliseconds-procs-all">
    2676. 

  2676.   <div id="milliseconds,int">
    2677. 

  2677.   <dt><pre><span class="Keyword">proc</span> <a href="#milliseconds%2Cint"><span class="Identifier">milliseconds</span></a><span class="Other">(</span><span class="Identifier">ms</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    2678. 

  2678.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2679. 

  2679.   <dd>
    2680. 

  2680.     
    2681. 

  2681.     TimeInterval of <tt class="docutils literal"><span class="pre"><span class="Identifier">ms</span></span></tt> milliseconds.
    2682. 

  2682.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2594" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2683. 

  2683. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2594" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2684. 

  2684. 

  2685.   </dd>
    2686. 

  2686. </div>
    2687. 

  2687. 

  2688. </div>
    2689. 

  2689. <div id="minute-procs-all">
    2690. 

  2690.   <div id="minute,DateTime">
    2691. 

  2691.   <dt><pre><span class="Keyword">proc</span> <a href="#minute%2CDateTime"><span class="Identifier">minute</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#MinuteRange"><span class="Identifier">MinuteRange</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    2692. 

  2692.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2693. 

  2693.   <dd>
    2694. 

  2694.     
    2695. 

  2695.     The number of minutes after the hour, in the range 0 to 59.
    2696. 

  2696.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1067" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2697. 

  2697. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1067" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2698. 

  2698. 

  2699.   </dd>
    2700. 

  2700. </div>
    2701. 

  2701. 

  2702. </div>
    2703. 

  2703. <div id="minute=-procs-all">
    2704. 

  2704.   <div id="minute=,DateTime,MinuteRange">
    2705. 

  2705.   <dt><pre><span class="Keyword">proc</span> <a href="#minute%3D%2CDateTime%2CMinuteRange"><span class="Identifier">minute=</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">;</span> <span class="Identifier">value</span><span class="Other">:</span> <a href="times.html#MinuteRange"><span class="Identifier">MinuteRange</span></a><span class="Other">)</span> {.
    2706. 

  2706.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;Deprecated since v1.3.1&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2707. 

  2707.   <dd>
    2708. 

  2708.     <div class="deprecation-message">
    2709. 

  2709.   <b>Deprecated:</b> Deprecated since v1.3.1
    2710. 

  2710. </div>
    2711. 

  2711. 

  2712.     
    2713. 

  2713.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2869" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2714. 

  2714. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2869" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2715. 

  2715. 

  2716.   </dd>
    2717. 

  2717. </div>
    2718. 

  2718. 

  2719. </div>
    2720. 

  2720. <div id="minutes-procs-all">
    2721. 

  2721.   <div id="minutes,int">
    2722. 

  2722.   <dt><pre><span class="Keyword">proc</span> <a href="#minutes%2Cint"><span class="Identifier">minutes</span></a><span class="Other">(</span><span class="Identifier">m</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2723. 

  2723.   <dd>
    2724. 

  2724.     
    2725. 

  2725.     <p>TimeInterval of <tt class="docutils literal"><span class="pre"><span class="Identifier">m</span></span></tt> minutes.</p>
    2726. 

  2726. <p><tt class="docutils literal"><span class="pre"><span class="Identifier">echo</span> <span class="Identifier">getTime</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">+</span> <span class="FloatNumber">5.</span><span class="Identifier">minutes</span></span></tt></p>
    2727. 

  2727. 

  2728.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2604" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2729. 

  2729. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2604" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2730. 

  2730. 

  2731.   </dd>
    2732. 

  2732. </div>
    2733. 

  2733. 

  2734. </div>
    2735. 

  2735. <div id="month-procs-all">
    2736. 

  2736.   <div id="month,DateTime">
    2737. 

  2737.   <dt><pre><span class="Keyword">proc</span> <a href="#month%2CDateTime"><span class="Identifier">month</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Month"><span class="Identifier">Month</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2738. 

  2738.   <dd>
    2739. 

  2739.     
    2740. 

  2740.     The month as an enum, the ordinal value is in the range 1 to 12.
    2741. 

  2741.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1085" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2742. 

  2742. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1085" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2743. 

  2743. 

  2744.   </dd>
    2745. 

  2745. </div>
    2746. 

  2746. 

  2747. </div>
    2748. 

  2748. <div id="monthday-procs-all">
    2749. 

  2749.   <div id="monthday,DateTime">
    2750. 

  2750.   <dt><pre><span class="Keyword">proc</span> <a href="#monthday%2CDateTime"><span class="Identifier">monthday</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#MonthdayRange"><span class="Identifier">MonthdayRange</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    2751. 

  2751.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2752. 

  2752.   <dd>
    2753. 

  2753.     
    2754. 

  2754.     The day of the month, in the range 1 to 31.
    2755. 

  2755.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1079" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2756. 

  2756. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1079" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2757. 

  2757. 

  2758.   </dd>
    2759. 

  2759. </div>
    2760. 

  2760. 

  2761. </div>
    2762. 

  2762. <div id="monthdayZero=-procs-all">
    2763. 

  2763.   <div id="monthdayZero=,DateTime,int">
    2764. 

  2764.   <dt><pre><span class="Keyword">proc</span> <a href="#monthdayZero%3D%2CDateTime%2Cint"><span class="Identifier">monthdayZero=</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">;</span> <span class="Identifier">value</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span> {.
    2765. 

  2765.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;Deprecated since v1.3.1&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2766. 

  2766.   <dd>
    2767. 

  2767.     <div class="deprecation-message">
    2768. 

  2768.   <b>Deprecated:</b> Deprecated since v1.3.1
    2769. 

  2769. </div>
    2770. 

  2770. 

  2771.     
    2772. 

  2772.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2875" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2773. 

  2773. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2875" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2774. 

  2774. 

  2775.   </dd>
    2776. 

  2776. </div>
    2777. 

  2777. 

  2778. </div>
    2779. 

  2779. <div id="months-procs-all">
    2780. 

  2780.   <div id="months,int">
    2781. 

  2781.   <dt><pre><span class="Keyword">proc</span> <a href="#months%2Cint"><span class="Identifier">months</span></a><span class="Other">(</span><span class="Identifier">m</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2782. 

  2782.   <dd>
    2783. 

  2783.     
    2784. 

  2784.     <p>TimeInterval of <tt class="docutils literal"><span class="pre"><span class="Identifier">m</span></span></tt> months.</p>
    2785. 

  2785. <p><tt class="docutils literal"><span class="pre"><span class="Identifier">echo</span> <span class="Identifier">getTime</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">+</span> <span class="FloatNumber">2.</span><span class="Identifier">months</span></span></tt></p>
    2786. 

  2786. 

  2787.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2628" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2788. 

  2788. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2628" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2789. 

  2789. 

  2790.   </dd>
    2791. 

  2791. </div>
    2792. 

  2792. 

  2793. </div>
    2794. 

  2794. <div id="monthZero=-procs-all">
    2795. 

  2795.   <div id="monthZero=,DateTime,int">
    2796. 

  2796.   <dt><pre><span class="Keyword">proc</span> <a href="#monthZero%3D%2CDateTime%2Cint"><span class="Identifier">monthZero=</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">;</span> <span class="Identifier">value</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span> {.
    2797. 

  2797.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;Deprecated since v1.3.1&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2798. 

  2798.   <dd>
    2799. 

  2799.     <div class="deprecation-message">
    2800. 

  2800.   <b>Deprecated:</b> Deprecated since v1.3.1
    2801. 

  2801. </div>
    2802. 

  2802. 

  2803.     
    2804. 

  2804.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2878" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2805. 

  2805. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2878" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2806. 

  2806. 

  2807.   </dd>
    2808. 

  2808. </div>
    2809. 

  2809. 

  2810. </div>
    2811. 

  2811. <div id="name-procs-all">
    2812. 

  2812.   <div id="name,Timezone">
    2813. 

  2813.   <dt><pre><span class="Keyword">proc</span> <a href="#name%2CTimezone"><span class="Identifier">name</span></a><span class="Other">(</span><span class="Identifier">zone</span><span class="Other">:</span> <a href="times.html#Timezone"><span class="Identifier">Timezone</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2814. 

  2814.   <dd>
    2815. 

  2815.     
    2816. 

  2816.     <p>The name of the timezone.</p>
    2817. 

  2817. <p>If possible, the name will be the name used in the tz database. If the timezone doesn't exist in the tz database, or if the timezone name is unknown, then any string that describes the timezone unambiguously might be used. For example, the string &quot;LOCAL&quot; is used for the system's local timezone.</p>
    2818. 

  2818. <p>See also: <a class="reference external" href="https://en.wikipedia.org/wiki/Tz_database">https://en.wikipedia.org/wiki/Tz_database</a></p>
    2819. 

  2819. 

  2820.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1225" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2821. 

  2821. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1225" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2822. 

  2822. 

  2823.   </dd>
    2824. 

  2824. </div>
    2825. 

  2825. 

  2826. </div>
    2827. 

  2827. <div id="nanosecond-procs-all">
    2828. 

  2828.   <div id="nanosecond,DateTime">
    2829. 

  2829.   <dt><pre><span class="Keyword">proc</span> <a href="#nanosecond%2CDateTime"><span class="Identifier">nanosecond</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#NanosecondRange"><span class="Identifier">NanosecondRange</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    2830. 

  2830.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2831. 

  2831.   <dd>
    2832. 

  2832.     
    2833. 

  2833.     The number of nanoseconds after the second, in the range 0 to 999_999_999.
    2834. 

  2834.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1055" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2835. 

  2835. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1055" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2836. 

  2836. 

  2837.   </dd>
    2838. 

  2838. </div>
    2839. 

  2839. <div id="nanosecond,Time">
    2840. 

  2840.   <dt><pre><span class="Keyword">proc</span> <a href="#nanosecond%2CTime"><span class="Identifier">nanosecond</span></a><span class="Other">(</span><span class="Identifier">time</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#NanosecondRange"><span class="Identifier">NanosecondRange</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2841. 

  2841.   <dd>
    2842. 

  2842.     
    2843. 

  2843.     Get the fractional part of a <tt class="docutils literal"><span class="pre"><span class="Identifier">Time</span></span></tt> as the number of nanoseconds of the second.
    2844. 

  2844.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L919" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2845. 

  2845. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L919" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2846. 

  2846. 

  2847.   </dd>
    2848. 

  2848. </div>
    2849. 

  2849. 

  2850. </div>
    2851. 

  2851. <div id="nanosecond=-procs-all">
    2852. 

  2852.   <div id="nanosecond=,DateTime,NanosecondRange">
    2853. 

  2853.   <dt><pre><span class="Keyword">proc</span> <a href="#nanosecond%3D%2CDateTime%2CNanosecondRange"><span class="Identifier">nanosecond=</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">;</span> <span class="Identifier">value</span><span class="Other">:</span> <a href="times.html#NanosecondRange"><span class="Identifier">NanosecondRange</span></a><span class="Other">)</span> {.
    2854. 

  2854.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;Deprecated since v1.3.1&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2855. 

  2855.   <dd>
    2856. 

  2856.     <div class="deprecation-message">
    2857. 

  2857.   <b>Deprecated:</b> Deprecated since v1.3.1
    2858. 

  2858. </div>
    2859. 

  2859. 

  2860.     
    2861. 

  2861.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2863" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2862. 

  2862. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2863" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2863. 

  2863. 

  2864.   </dd>
    2865. 

  2865. </div>
    2866. 

  2866. 

  2867. </div>
    2868. 

  2868. <div id="nanoseconds-procs-all">
    2869. 

  2869.   <div id="nanoseconds,int">
    2870. 

  2870.   <dt><pre><span class="Keyword">proc</span> <a href="#nanoseconds%2Cint"><span class="Identifier">nanoseconds</span></a><span class="Other">(</span><span class="Identifier">nanos</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    2871. 

  2871.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2872. 

  2872.   <dd>
    2873. 

  2873.     
    2874. 

  2874.     TimeInterval of <tt class="docutils literal"><span class="pre"><span class="Identifier">nanos</span></span></tt> nanoseconds.
    2875. 

  2875.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2586" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2876. 

  2876. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2586" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2877. 

  2877. 

  2878.   </dd>
    2879. 

  2879. </div>
    2880. 

  2880. 

  2881. </div>
    2882. 

  2882. <div id="newTimezone-procs-all">
    2883. 

  2883.   <div id="newTimezone,string,proc(Time),proc(Time)">
    2884. 

  2884.   <dt><pre><span class="Keyword">proc</span> <a href="#newTimezone%2Cstring%2Cproc%28Time%29%2Cproc%28Time%29"><span class="Identifier">newTimezone</span></a><span class="Other">(</span><span class="Identifier">name</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">zonedTimeFromTimeImpl</span><span class="Other">:</span> <span class="Keyword">proc</span> <span class="Other">(</span><span class="Identifier">time</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#ZonedTime"><span class="Identifier">ZonedTime</span></a> {.
    2885. 

  2885.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">gcsafe</span></span>.}<span class="Other">;</span> <span class="Identifier">zonedTimeFromAdjTimeImpl</span><span class="Other">:</span> <span class="Keyword">proc</span> <span class="Other">(</span>
    2886. 

  2886.     <span class="Identifier">adjTime</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#ZonedTime"><span class="Identifier">ZonedTime</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">gcsafe</span></span>.}<span class="Other">)</span><span class="Other">:</span> <span class="Identifier">owned</span> <span class="Identifier">Timezone</span> {.
    2887. 

  2887.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2888. 

  2888.   <dd>
    2889. 

  2889.     
    2890. 

  2890.     <p>Create a new <tt class="docutils literal"><span class="pre"><span class="Identifier">Timezone</span></span></tt>.</p>
    2891. 

  2891. <p><tt class="docutils literal"><span class="pre"><span class="Identifier">zonedTimeFromTimeImpl</span></span></tt> and <tt class="docutils literal"><span class="pre"><span class="Identifier">zonedTimeFromAdjTimeImpl</span></span></tt> is used as the underlying implementations for <tt class="docutils literal"><span class="pre"><span class="Identifier">zonedTimeFromTime</span></span></tt> and <tt class="docutils literal"><span class="pre"><span class="Identifier">zonedTimeFromAdjTime</span></span></tt>.</p>
    2892. 

  2892. <p>If possible, the name parameter should match the name used in the tz database. If the timezone doesn't exist in the tz database, or if the timezone name is unknown, then any string that describes the timezone unambiguously can be used. Note that the timezones name is used for checking equality!</p>
    2893. 

  2893. 

  2894. <p><strong class="examples_text">Example:</strong></p>
    2895. 

  2895. <pre class="listing"><span class="Keyword">proc</span> <span class="Identifier">utcTzInfo</span><span class="Punctuation">(</span><span class="Identifier">time</span><span class="Punctuation">:</span> <span class="Identifier">Time</span><span class="Punctuation">)</span><span class="Punctuation">:</span> <span class="Identifier">ZonedTime</span> <span class="Operator">=</span>
    2896. 

  2896.   <span class="Identifier">ZonedTime</span><span class="Punctuation">(</span><span class="Identifier">utcOffset</span><span class="Punctuation">:</span> <span class="DecNumber">0</span><span class="Punctuation">,</span> <span class="Identifier">isDst</span><span class="Punctuation">:</span> <span class="Identifier">false</span><span class="Punctuation">,</span> <span class="Identifier">time</span><span class="Punctuation">:</span> <span class="Identifier">time</span><span class="Punctuation">)</span>
    2897. 

  2897. <span class="Keyword">let</span> <span class="Identifier">utc</span> <span class="Operator">=</span> <span class="Identifier">newTimezone</span><span class="Punctuation">(</span><span class="StringLit">&quot;Etc/UTC&quot;</span><span class="Punctuation">,</span> <span class="Identifier">utcTzInfo</span><span class="Punctuation">,</span> <span class="Identifier">utcTzInfo</span><span class="Punctuation">)</span></pre>
    2898. 

  2898.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1197" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2899. 

  2899. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1197" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2900. 

  2900. 

  2901.   </dd>
    2902. 

  2902. </div>
    2903. 

  2903. 

  2904. </div>
    2905. 

  2905. <div id="now-procs-all">
    2906. 

  2906.   <div id="now">
    2907. 

  2907.   <dt><pre><span class="Keyword">proc</span> <a href="#now"><span class="Identifier">now</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><a href="exceptions.html#TimeEffect"><span class="Identifier">TimeEffect</span></a><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2908. 

  2908.   <dd>
    2909. 

  2909.     
    2910. 

  2910.     Get the current time as a  <tt class="docutils literal"><span class="pre"><span class="Identifier">DateTime</span></span></tt> in the local timezone. Shorthand for <tt class="docutils literal"><span class="pre"><span class="Identifier">getTime</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Operator">.</span><span class="Identifier">local</span></span></tt>.<div class="admonition admonition-warning"><span class="admonition-warning-text"><b>Warning:</b></span>
    2911. 

  2911. Unsuitable for benchmarking, use <tt class="docutils literal"><span class="pre"><span class="Identifier">monotimes</span><span class="Operator">.</span><span class="Identifier">getMonoTime</span></span></tt> or <tt class="docutils literal"><span class="pre"><span class="Identifier">cpuTime</span></span></tt> instead, depending on the use case.</div>
    2912. 

  2912. 

  2913.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1411" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2914. 

  2914. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1411" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2915. 

  2915. 

  2916.   </dd>
    2917. 

  2917. </div>
    2918. 

  2918. 

  2919. </div>
    2920. 

  2920. <div id="parse-procs-all">
    2921. 

  2921.   <div id="parse,string,string,Timezone,DateTimeLocale">
    2922. 

  2922.   <dt><pre><span class="Keyword">proc</span> <a href="#parse%2Cstring%2Cstring%2CTimezone%2CDateTimeLocale"><span class="Identifier">parse</span></a><span class="Other">(</span><span class="Identifier">input</span><span class="Other">,</span> <span class="Identifier">f</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">tz</span><span class="Other">:</span> <a href="times.html#Timezone"><span class="Identifier">Timezone</span></a> <span class="Other">=</span> <span class="Identifier">local</span><span class="Other">(</span><span class="Other">)</span><span class="Other">;</span>
    2923. 

  2923.            <span class="Identifier">loc</span><span class="Other">:</span> <a href="times.html#DateTimeLocale"><span class="Identifier">DateTimeLocale</span></a> <span class="Other">=</span> <span class="Identifier">DefaultLocale</span><span class="Other">)</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a> {.
    2924. 

  2924.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><a href="times.html#TimeParseError"><span class="Identifier">TimeParseError</span></a><span class="Other">,</span> <a href="times.html#TimeFormatParseError"><span class="Identifier">TimeFormatParseError</span></a><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span>
    2925. 

  2925.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2926. 

  2926.   <dd>
    2927. 

  2927.     
    2928. 

  2928.     <p>Shorthand for constructing a <tt class="docutils literal"><span class="pre"><span class="Identifier">TimeFormat</span></span></tt> and using it to parse <tt class="docutils literal"><span class="pre"><span class="Identifier">input</span></span></tt> as a <tt class="docutils literal"><span class="pre"><span class="Identifier">DateTime</span></span></tt>.</p>
    2929. 

  2929. <p>See <a class="reference internal" href="#parsing-and-formatting-dates">Parsing and formatting dates</a> for documentation of the <tt class="docutils literal"><span class="pre"><span class="Identifier">f</span></span></tt> argument.</p>
    2930. 

  2930. 

  2931. <p><strong class="examples_text">Example:</strong></p>
    2932. 

  2932. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">dt</span> <span class="Operator">=</span> <span class="Identifier">dateTime</span><span class="Punctuation">(</span><span class="DecNumber">2000</span><span class="Punctuation">,</span> <span class="Identifier">mJan</span><span class="Punctuation">,</span> <span class="DecNumber">01</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
    2933. 

  2933. <span class="Identifier">doAssert</span> <span class="Identifier">dt</span> <span class="Operator">==</span> <span class="Identifier">parse</span><span class="Punctuation">(</span><span class="StringLit">&quot;2000-01-01&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;yyyy-MM-dd&quot;</span><span class="Punctuation">,</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre>
    2934. 

  2934.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2295" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2935. 

  2935. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2295" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2936. 

  2936. 

  2937.   </dd>
    2938. 

  2938. </div>
    2939. 

  2939. <div id="parse,string,static[string],Timezone,DateTimeLocale">
    2940. 

  2940.   <dt><pre><span class="Keyword">proc</span> <a href="#parse%2Cstring%2Cstatic%5Bstring%5D%2CTimezone%2CDateTimeLocale"><span class="Identifier">parse</span></a><span class="Other">(</span><span class="Identifier">input</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">f</span><span class="Other">:</span> <a href="system.html#static"><span class="Identifier">static</span></a><span class="Other">[</span><a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">zone</span><span class="Other">:</span> <a href="times.html#Timezone"><span class="Identifier">Timezone</span></a> <span class="Other">=</span> <span class="Identifier">local</span><span class="Other">(</span><span class="Other">)</span><span class="Other">;</span>
    2941. 

  2941.            <span class="Identifier">loc</span><span class="Other">:</span> <a href="times.html#DateTimeLocale"><span class="Identifier">DateTimeLocale</span></a> <span class="Other">=</span> <span class="Identifier">DefaultLocale</span><span class="Other">)</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a> {.
    2942. 

  2942.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><a href="times.html#TimeParseError"><span class="Identifier">TimeParseError</span></a><span class="Other">]</span></span>.}</pre></dt>
    2943. 

  2943.   <dd>
    2944. 

  2944.     
    2945. 

  2945.     Overload that validates <tt class="docutils literal"><span class="pre"><span class="Identifier">f</span></span></tt> at compile time.
    2946. 

  2946.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2308" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2947. 

  2947. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2308" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2948. 

  2948. 

  2949.   </dd>
    2950. 

  2950. </div>
    2951. 

  2951. <div id="parse,string,TimeFormat,Timezone,DateTimeLocale">
    2952. 

  2952.   <dt><pre><span class="Keyword">proc</span> <a href="#parse%2Cstring%2CTimeFormat%2CTimezone%2CDateTimeLocale"><span class="Identifier">parse</span></a><span class="Other">(</span><span class="Identifier">input</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">f</span><span class="Other">:</span> <a href="times.html#TimeFormat"><span class="Identifier">TimeFormat</span></a><span class="Other">;</span> <span class="Identifier">zone</span><span class="Other">:</span> <a href="times.html#Timezone"><span class="Identifier">Timezone</span></a> <span class="Other">=</span> <span class="Identifier">local</span><span class="Other">(</span><span class="Other">)</span><span class="Other">;</span>
    2953. 

  2953.            <span class="Identifier">loc</span><span class="Other">:</span> <a href="times.html#DateTimeLocale"><span class="Identifier">DateTimeLocale</span></a> <span class="Other">=</span> <span class="Identifier">DefaultLocale</span><span class="Other">)</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a> {.
    2954. 

  2954.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><a href="times.html#TimeParseError"><span class="Identifier">TimeParseError</span></a><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2955. 

  2955.   <dd>
    2956. 

  2956.     
    2957. 

  2957.     <p>Parses <tt class="docutils literal"><span class="pre"><span class="Identifier">input</span></span></tt> as a <tt class="docutils literal"><span class="pre"><span class="Identifier">DateTime</span></span></tt> using the format specified by <tt class="docutils literal"><span class="pre"><span class="Identifier">f</span></span></tt>. If no UTC offset was parsed, then <tt class="docutils literal"><span class="pre"><span class="Identifier">input</span></span></tt> is assumed to be specified in the <tt class="docutils literal"><span class="pre"><span class="Identifier">zone</span></span></tt> timezone. If a UTC offset was parsed, the result will be converted to the <tt class="docutils literal"><span class="pre"><span class="Identifier">zone</span></span></tt> timezone.</p>
    2958. 

  2958. <p>Month and day names from the passed in <tt class="docutils literal"><span class="pre"><span class="Identifier">loc</span></span></tt> are used.</p>
    2959. 

  2959. 

  2960. <p><strong class="examples_text">Example:</strong></p>
    2961. 

  2961. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">f</span> <span class="Operator">=</span> <span class="Identifier">initTimeFormat</span><span class="Punctuation">(</span><span class="StringLit">&quot;yyyy-MM-dd&quot;</span><span class="Punctuation">)</span>
    2962. 

  2962. <span class="Keyword">let</span> <span class="Identifier">dt</span> <span class="Operator">=</span> <span class="Identifier">dateTime</span><span class="Punctuation">(</span><span class="DecNumber">2000</span><span class="Punctuation">,</span> <span class="Identifier">mJan</span><span class="Punctuation">,</span> <span class="DecNumber">01</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="DecNumber">00</span><span class="Punctuation">,</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
    2963. 

  2963. <span class="Identifier">doAssert</span> <span class="Identifier">dt</span> <span class="Operator">==</span> <span class="StringLit">&quot;2000-01-01&quot;</span><span class="Operator">.</span><span class="Identifier">parse</span><span class="Punctuation">(</span><span class="Identifier">f</span><span class="Punctuation">,</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre>
    2964. 

  2964.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2246" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2965. 

  2965. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2246" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2966. 

  2966. 

  2967.   </dd>
    2968. 

  2968. </div>
    2969. 

  2969. 

  2970. </div>
    2971. 

  2971. <div id="parseTime-procs-all">
    2972. 

  2972.   <div id="parseTime,string,string,Timezone">
    2973. 

  2973.   <dt><pre><span class="Keyword">proc</span> <a href="#parseTime%2Cstring%2Cstring%2CTimezone"><span class="Identifier">parseTime</span></a><span class="Other">(</span><span class="Identifier">input</span><span class="Other">,</span> <span class="Identifier">f</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">zone</span><span class="Other">:</span> <a href="times.html#Timezone"><span class="Identifier">Timezone</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a> {.
    2974. 

  2974.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><a href="times.html#TimeParseError"><span class="Identifier">TimeParseError</span></a><span class="Other">,</span> <a href="times.html#TimeFormatParseError"><span class="Identifier">TimeFormatParseError</span></a><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Identifier">TimeEffect</span><span class="Other">]</span><span class="Other">,</span>
    2975. 

  2975.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    2976. 

  2976.   <dd>
    2977. 

  2977.     
    2978. 

  2978.     <p>Shorthand for constructing a <tt class="docutils literal"><span class="pre"><span class="Identifier">TimeFormat</span></span></tt> and using it to parse <tt class="docutils literal"><span class="pre"><span class="Identifier">input</span></span></tt> as a <tt class="docutils literal"><span class="pre"><span class="Identifier">DateTime</span></span></tt>, then converting it a <tt class="docutils literal"><span class="pre"><span class="Identifier">Time</span></span></tt>.</p>
    2979. 

  2979. <p>See <a class="reference internal" href="#parsing-and-formatting-dates">Parsing and formatting dates</a> for documentation of the <tt class="docutils literal"><span class="pre"><span class="Identifier">format</span></span></tt> argument.</p>
    2980. 

  2980. 

  2981. <p><strong class="examples_text">Example:</strong></p>
    2982. 

  2982. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">tStr</span> <span class="Operator">=</span> <span class="StringLit">&quot;1970-01-01T00:00:00+00:00&quot;</span>
    2983. 

  2983. <span class="Identifier">doAssert</span> <span class="Identifier">parseTime</span><span class="Punctuation">(</span><span class="Identifier">tStr</span><span class="Punctuation">,</span> <span class="StringLit">&quot;yyyy-MM-dd'T'HH:mm:sszzz&quot;</span><span class="Punctuation">,</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="Identifier">fromUnix</span><span class="Punctuation">(</span><span class="DecNumber">0</span><span class="Punctuation">)</span></pre>
    2984. 

  2984.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2314" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2985. 

  2985. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2314" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2986. 

  2986. 

  2987.   </dd>
    2988. 

  2988. </div>
    2989. 

  2989. <div id="parseTime,string,static[string],Timezone">
    2990. 

  2990.   <dt><pre><span class="Keyword">proc</span> <a href="#parseTime%2Cstring%2Cstatic%5Bstring%5D%2CTimezone"><span class="Identifier">parseTime</span></a><span class="Other">(</span><span class="Identifier">input</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">f</span><span class="Other">:</span> <a href="system.html#static"><span class="Identifier">static</span></a><span class="Other">[</span><a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">zone</span><span class="Other">:</span> <a href="times.html#Timezone"><span class="Identifier">Timezone</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a> {.
    2991. 

  2991.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><a href="times.html#TimeParseError"><span class="Identifier">TimeParseError</span></a><span class="Other">]</span></span>.}</pre></dt>
    2992. 

  2992.   <dd>
    2993. 

  2993.     
    2994. 

  2994.     Overload that validates <tt class="docutils literal"><span class="pre"><span class="Identifier">format</span></span></tt> at compile time.
    2995. 

  2995.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2325" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    2996. 

  2996. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2325" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    2997. 

  2997. 

  2998.   </dd>
    2999. 

  2999. </div>
    3000. 

  3000. 

  3001. </div>
    3002. 

  3002. <div id="second-procs-all">
    3003. 

  3003.   <div id="second,DateTime">
    3004. 

  3004.   <dt><pre><span class="Keyword">proc</span> <a href="#second%2CDateTime"><span class="Identifier">second</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#SecondRange"><span class="Identifier">SecondRange</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    3005. 

  3005.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3006. 

  3006.   <dd>
    3007. 

  3007.     
    3008. 

  3008.     The number of seconds after the minute, in the range 0 to 59.
    3009. 

  3009.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1061" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3010. 

  3010. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1061" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3011. 

  3011. 

  3012.   </dd>
    3013. 

  3013. </div>
    3014. 

  3014. 

  3015. </div>
    3016. 

  3016. <div id="second=-procs-all">
    3017. 

  3017.   <div id="second=,DateTime,SecondRange">
    3018. 

  3018.   <dt><pre><span class="Keyword">proc</span> <a href="#second%3D%2CDateTime%2CSecondRange"><span class="Identifier">second=</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">;</span> <span class="Identifier">value</span><span class="Other">:</span> <a href="times.html#SecondRange"><span class="Identifier">SecondRange</span></a><span class="Other">)</span> {.
    3019. 

  3019.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;Deprecated since v1.3.1&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3020. 

  3020.   <dd>
    3021. 

  3021.     <div class="deprecation-message">
    3022. 

  3022.   <b>Deprecated:</b> Deprecated since v1.3.1
    3023. 

  3023. </div>
    3024. 

  3024. 

  3025.     
    3026. 

  3026.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2866" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3027. 

  3027. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2866" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3028. 

  3028. 

  3029.   </dd>
    3030. 

  3030. </div>
    3031. 

  3031. 

  3032. </div>
    3033. 

  3033. <div id="seconds-procs-all">
    3034. 

  3034.   <div id="seconds,int">
    3035. 

  3035.   <dt><pre><span class="Keyword">proc</span> <a href="#seconds%2Cint"><span class="Identifier">seconds</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3036. 

  3036.   <dd>
    3037. 

  3037.     
    3038. 

  3038.     <p>TimeInterval of <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> seconds.</p>
    3039. 

  3039. <p><tt class="docutils literal"><span class="pre"><span class="Identifier">echo</span> <span class="Identifier">getTime</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">+</span> <span class="FloatNumber">5.</span><span class="Identifier">seconds</span></span></tt></p>
    3040. 

  3040. 

  3041.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2598" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3042. 

  3042. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2598" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3043. 

  3043. 

  3044.   </dd>
    3045. 

  3045. </div>
    3046. 

  3046. 

  3047. </div>
    3048. 

  3048. <div id="timezone-procs-all">
    3049. 

  3049.   <div id="timezone,DateTime">
    3050. 

  3050.   <dt><pre><span class="Keyword">proc</span> <a href="#timezone%2CDateTime"><span class="Identifier">timezone</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Timezone"><span class="Identifier">Timezone</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    3051. 

  3051.                                         <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3052. 

  3052.   <dd>
    3053. 

  3053.     
    3054. 

  3054.     The timezone represented as an implementation of <tt class="docutils literal"><span class="pre"><span class="Identifier">Timezone</span></span></tt>.
    3055. 

  3055.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1117" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3056. 

  3056. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1117" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3057. 

  3057. 

  3058.   </dd>
    3059. 

  3059. </div>
    3060. 

  3060. 

  3061. </div>
    3062. 

  3062. <div id="timezone=-procs-all">
    3063. 

  3063.   <div id="timezone=,DateTime,Timezone">
    3064. 

  3064.   <dt><pre><span class="Keyword">proc</span> <a href="#timezone%3D%2CDateTime%2CTimezone"><span class="Identifier">timezone=</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">;</span> <span class="Identifier">value</span><span class="Other">:</span> <a href="times.html#Timezone"><span class="Identifier">Timezone</span></a><span class="Other">)</span> {.
    3065. 

  3065.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;Deprecated since v1.3.1&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3066. 

  3066.   <dd>
    3067. 

  3067.     <div class="deprecation-message">
    3068. 

  3068.   <b>Deprecated:</b> Deprecated since v1.3.1
    3069. 

  3069. </div>
    3070. 

  3070. 

  3071.     
    3072. 

  3072.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2893" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3073. 

  3073. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2893" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3074. 

  3074. 

  3075.   </dd>
    3076. 

  3076. </div>
    3077. 

  3077. 

  3078. </div>
    3079. 

  3079. <div id="toParts-procs-all">
    3080. 

  3080.   <div id="toParts,Duration">
    3081. 

  3081.   <dt><pre><span class="Keyword">proc</span> <a href="#toParts%2CDuration"><span class="Identifier">toParts</span></a><span class="Other">(</span><span class="Identifier">dur</span><span class="Other">:</span> <a href="times.html#Duration"><span class="Identifier">Duration</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#DurationParts"><span class="Identifier">DurationParts</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3082. 

  3082.   <dd>
    3083. 

  3083.     
    3084. 

  3084.     <p>Converts a duration into an array consisting of fixed time units.</p>
    3085. 

  3085. <p>Each value in the array gives information about a specific unit of time, for example <tt class="docutils literal"><span class="pre"><span class="Identifier">result</span><span class="Punctuation">[</span><span class="Identifier">Days</span><span class="Punctuation">]</span></span></tt> gives a count of days.</p>
    3086. 

  3086. <p>This procedure is useful for converting <tt class="docutils literal"><span class="pre"><span class="Identifier">Duration</span></span></tt> values to strings.</p>
    3087. 

  3087. 

  3088. <p><strong class="examples_text">Example:</strong></p>
    3089. 

  3089. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">dp</span> <span class="Operator">=</span> <span class="Identifier">toParts</span><span class="Punctuation">(</span><span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">weeks</span> <span class="Operator">=</span> <span class="DecNumber">2</span><span class="Punctuation">,</span> <span class="Identifier">days</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
    3090. 

  3090. <span class="Identifier">doAssert</span> <span class="Identifier">dp</span><span class="Punctuation">[</span><span class="Identifier">Days</span><span class="Punctuation">]</span> <span class="Operator">==</span> <span class="DecNumber">1</span>
    3091. 

  3091. <span class="Identifier">doAssert</span> <span class="Identifier">dp</span><span class="Punctuation">[</span><span class="Identifier">Weeks</span><span class="Punctuation">]</span> <span class="Operator">==</span> <span class="DecNumber">2</span>
    3092. 

  3092. <span class="Identifier">doAssert</span> <span class="Identifier">dp</span><span class="Punctuation">[</span><span class="Identifier">Minutes</span><span class="Punctuation">]</span> <span class="Operator">==</span> <span class="DecNumber">0</span>
    3093. 

  3093. <span class="Identifier">dp</span> <span class="Operator">=</span> <span class="Identifier">toParts</span><span class="Punctuation">(</span><span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">days</span> <span class="Operator">=</span> <span class="Operator">-</span><span class="DecNumber">1</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
    3094. 

  3094. <span class="Identifier">doAssert</span> <span class="Identifier">dp</span><span class="Punctuation">[</span><span class="Identifier">Days</span><span class="Punctuation">]</span> <span class="Operator">==</span> <span class="Operator">-</span><span class="DecNumber">1</span></pre>
    3095. 

  3095.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L762" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3096. 

  3096. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L762" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3097. 

  3097. 

  3098.   </dd>
    3099. 

  3099. </div>
    3100. 

  3100. <div id="toParts,TimeInterval">
    3101. 

  3101.   <dt><pre><span class="Keyword">proc</span> <a href="#toParts%2CTimeInterval"><span class="Identifier">toParts</span></a><span class="Other">(</span><span class="Identifier">ti</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#TimeIntervalParts"><span class="Identifier">TimeIntervalParts</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    3102. 

  3102.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3103. 

  3103.   <dd>
    3104. 

  3104.     
    3105. 

  3105.     <p>Converts a <tt class="docutils literal"><span class="pre"><span class="Identifier">TimeInterval</span></span></tt> into an array consisting of its time units, starting with nanoseconds and ending with years.</p>
    3106. 

  3106. <p>This procedure is useful for converting <tt class="docutils literal"><span class="pre"><span class="Identifier">TimeInterval</span></span></tt> values to strings. E.g. then you need to implement custom interval printing</p>
    3107. 

  3107. 

  3108. <p><strong class="examples_text">Example:</strong></p>
    3109. 

  3109. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">tp</span> <span class="Operator">=</span> <span class="Identifier">toParts</span><span class="Punctuation">(</span><span class="Identifier">initTimeInterval</span><span class="Punctuation">(</span><span class="Identifier">years</span> <span class="Operator">=</span> <span class="DecNumber">1</span><span class="Punctuation">,</span> <span class="Identifier">nanoseconds</span> <span class="Operator">=</span> <span class="DecNumber">123</span><span class="Punctuation">)</span><span class="Punctuation">)</span>
    3110. 

  3110. <span class="Identifier">doAssert</span> <span class="Identifier">tp</span><span class="Punctuation">[</span><span class="Identifier">Years</span><span class="Punctuation">]</span> <span class="Operator">==</span> <span class="DecNumber">1</span>
    3111. 

  3111. <span class="Identifier">doAssert</span> <span class="Identifier">tp</span><span class="Punctuation">[</span><span class="Identifier">Nanoseconds</span><span class="Punctuation">]</span> <span class="Operator">==</span> <span class="DecNumber">123</span></pre>
    3112. 

  3112.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2555" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3113. 

  3113. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2555" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3114. 

  3114. 

  3115.   </dd>
    3116. 

  3116. </div>
    3117. 

  3117. 

  3118. </div>
    3119. 

  3119. <div id="toTime-procs-all">
    3120. 

  3120.   <div id="toTime,DateTime">
    3121. 

  3121.   <dt><pre><span class="Keyword">proc</span> <a href="#toTime%2CDateTime"><span class="Identifier">toTime</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3122. 

  3122.   <dd>
    3123. 

  3123.     
    3124. 

  3124.     Converts a <tt class="docutils literal"><span class="pre"><span class="Identifier">DateTime</span></span></tt> to a <tt class="docutils literal"><span class="pre"><span class="Identifier">Time</span></span></tt> representing the same point in time.
    3125. 

  3125.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1157" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3126. 

  3126. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1157" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3127. 

  3127. 

  3128.   </dd>
    3129. 

  3129. </div>
    3130. 

  3130. 

  3131. </div>
    3132. 

  3132. <div id="toUnix-procs-all">
    3133. 

  3133.   <div id="toUnix,Time">
    3134. 

  3134.   <dt><pre><span class="Keyword">proc</span> <a href="#toUnix%2CTime"><span class="Identifier">toUnix</span></a><span class="Other">(</span><span class="Identifier">t</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int64"><span class="Identifier">int64</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> </span><span class="Identifier">noSideEffect</span><span class="Other">,</span>
    3135. 

  3135.                               <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3136. 

  3136.   <dd>
    3137. 

  3137.     
    3138. 

  3138.     Convert <tt class="docutils literal"><span class="pre"><span class="Identifier">t</span></span></tt> to a unix timestamp (seconds since <tt class="docutils literal"><span class="pre"><span class="DecNumber">1970</span><span class="Operator">-</span><span class="DecNumber">01</span><span class="Operator">-</span><span class="DecNumber">01</span><span class="Identifier">T00</span><span class="Punctuation">:</span><span class="DecNumber">00</span><span class="Punctuation">:</span><span class="DecNumber">00</span><span class="Identifier">Z</span></span></tt>). See also <tt class="docutils literal"><span class="pre"><span class="Identifier">toUnixFloat</span></span></tt> for subsecond resolution.
    3139. 

  3139. <p><strong class="examples_text">Example:</strong></p>
    3140. 

  3140. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">fromUnix</span><span class="Punctuation">(</span><span class="DecNumber">0</span><span class="Punctuation">)</span><span class="Operator">.</span><span class="Identifier">toUnix</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">0</span></pre>
    3141. 

  3141.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L932" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3142. 

  3142. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L932" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3143. 

  3143. 

  3144.   </dd>
    3145. 

  3145. </div>
    3146. 

  3146. 

  3147. </div>
    3148. 

  3148. <div id="toUnixFloat-procs-all">
    3149. 

  3149.   <div id="toUnixFloat,Time">
    3150. 

  3150.   <dt><pre><span class="Keyword">proc</span> <a href="#toUnixFloat%2CTime"><span class="Identifier">toUnixFloat</span></a><span class="Other">(</span><span class="Identifier">t</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#float"><span class="Identifier">float</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">gcsafe</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3151. 

  3151.   <dd>
    3152. 

  3152.     
    3153. 

  3153.     Same as <tt class="docutils literal"><span class="pre"><span class="Identifier">toUnix</span></span></tt> but using subsecond resolution.
    3154. 

  3154. <p><strong class="examples_text">Example:</strong></p>
    3155. 

  3155. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">t</span> <span class="Operator">=</span> <span class="Identifier">getTime</span><span class="Punctuation">(</span><span class="Punctuation">)</span>
    3156. 

  3156. <span class="Comment"># `&lt;` because of rounding errors</span>
    3157. 

  3157. <span class="Identifier">doAssert</span> <span class="Identifier">abs</span><span class="Punctuation">(</span><span class="Identifier">t</span><span class="Operator">.</span><span class="Identifier">toUnixFloat</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Operator">.</span><span class="Identifier">fromUnixFloat</span> <span class="Operator">-</span> <span class="Identifier">t</span><span class="Punctuation">)</span> <span class="Operator">&lt;</span> <span class="Identifier">initDuration</span><span class="Punctuation">(</span><span class="Identifier">nanoseconds</span> <span class="Operator">=</span> <span class="DecNumber">1000</span><span class="Punctuation">)</span></pre>
    3158. 

  3158.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L949" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3159. 

  3159. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L949" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3160. 

  3160. 

  3161.   </dd>
    3162. 

  3162. </div>
    3163. 

  3163. 

  3164. </div>
    3165. 

  3165. <div id="toWinTime-procs-all">
    3166. 

  3166.   <div id="toWinTime,Time">
    3167. 

  3167.   <dt><pre><span class="Keyword">proc</span> <a href="#toWinTime%2CTime"><span class="Identifier">toWinTime</span></a><span class="Other">(</span><span class="Identifier">t</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int64"><span class="Identifier">int64</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3168. 

  3168.   <dd>
    3169. 

  3169.     
    3170. 

  3170.     Convert <tt class="docutils literal"><span class="pre"><span class="Identifier">t</span></span></tt> to a Windows file time (100-nanosecond intervals since <tt class="docutils literal"><span class="pre"><span class="DecNumber">1601</span><span class="Operator">-</span><span class="DecNumber">01</span><span class="Operator">-</span><span class="DecNumber">01</span><span class="Identifier">T00</span><span class="Punctuation">:</span><span class="DecNumber">00</span><span class="Punctuation">:</span><span class="DecNumber">00</span><span class="Identifier">Z</span></span></tt>).
    3171. 

  3171.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L970" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3172. 

  3172. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L970" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3173. 

  3173. 

  3174.   </dd>
    3175. 

  3175. </div>
    3176. 

  3176. 

  3177. </div>
    3178. 

  3178. <div id="utc-procs-all">
    3179. 

  3179.   <div id="utc">
    3180. 

  3180.   <dt><pre><span class="Keyword">proc</span> <a href="#utc"><span class="Identifier">utc</span></a><span class="Other">(</span><span class="Other">)</span><span class="Other">:</span> <a href="times.html#Timezone"><span class="Identifier">Timezone</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3181. 

  3181.   <dd>
    3182. 

  3182.     
    3183. 

  3183.     Get the <tt class="docutils literal"><span class="pre"><span class="Identifier">Timezone</span></span></tt> implementation for the UTC timezone.
    3184. 

  3184. <p><strong class="examples_text">Example:</strong></p>
    3185. 

  3185. <pre class="listing"><span class="Identifier">doAssert</span> <span class="Identifier">now</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Operator">.</span><span class="Identifier">utc</span><span class="Operator">.</span><span class="Identifier">timezone</span> <span class="Operator">==</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span>
    3186. 

  3186. <span class="Identifier">doAssert</span> <span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Operator">.</span><span class="Identifier">name</span> <span class="Operator">==</span> <span class="StringLit">&quot;Etc/UTC&quot;</span></pre>
    3187. 

  3187.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1376" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3188. 

  3188. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1376" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3189. 

  3189. 

  3190.   </dd>
    3191. 

  3191. </div>
    3192. 

  3192. <div id="utc,DateTime">
    3193. 

  3193.   <dt><pre><span class="Keyword">proc</span> <a href="#utc%2CDateTime"><span class="Identifier">utc</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3194. 

  3194.   <dd>
    3195. 

  3195.     
    3196. 

  3196.     Shorthand for <tt class="docutils literal"><span class="pre"><span class="Identifier">dt</span><span class="Operator">.</span><span class="Identifier">inZone</span><span class="Punctuation">(</span><span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span></span></tt>.
    3197. 

  3197.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1395" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3198. 

  3198. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1395" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3199. 

  3199. 

  3200.   </dd>
    3201. 

  3201. </div>
    3202. 

  3202. <div id="utc,Time">
    3203. 

  3203.   <dt><pre><span class="Keyword">proc</span> <a href="#utc%2CTime"><span class="Identifier">utc</span></a><span class="Other">(</span><span class="Identifier">t</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3204. 

  3204.   <dd>
    3205. 

  3205.     
    3206. 

  3206.     Shorthand for <tt class="docutils literal"><span class="pre"><span class="Identifier">t</span><span class="Operator">.</span><span class="Identifier">inZone</span><span class="Punctuation">(</span><span class="Identifier">utc</span><span class="Punctuation">(</span><span class="Punctuation">)</span><span class="Punctuation">)</span></span></tt>.
    3207. 

  3207.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1403" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3208. 

  3208. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1403" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3209. 

  3209. 

  3210.   </dd>
    3211. 

  3211. </div>
    3212. 

  3212. 

  3213. </div>
    3214. 

  3214. <div id="utcOffset-procs-all">
    3215. 

  3215.   <div id="utcOffset,DateTime">
    3216. 

  3216.   <dt><pre><span class="Keyword">proc</span> <a href="#utcOffset%2CDateTime"><span class="Identifier">utcOffset</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3217. 

  3217.   <dd>
    3218. 

  3218.     
    3219. 

  3219.     The offset in seconds west of UTC, including any offset due to DST. Note that the sign of this number is the opposite of the one in a formatted offset string like <tt class="docutils literal"><span class="pre"><span class="Operator">+</span><span class="DecNumber">01</span><span class="Punctuation">:</span><span class="DecNumber">00</span></span></tt> (which would be equivalent to the UTC offset <tt class="docutils literal"><span class="pre"><span class="Operator">-</span><span class="DecNumber">3600</span></span></tt>).
    3220. 

  3220.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1123" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3221. 

  3221. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1123" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3222. 

  3222. 

  3223.   </dd>
    3224. 

  3224. </div>
    3225. 

  3225. 

  3226. </div>
    3227. 

  3227. <div id="utcOffset=-procs-all">
    3228. 

  3228.   <div id="utcOffset=,DateTime,int">
    3229. 

  3229.   <dt><pre><span class="Keyword">proc</span> <a href="#utcOffset%3D%2CDateTime%2Cint"><span class="Identifier">utcOffset=</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">;</span> <span class="Identifier">value</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span> {.
    3230. 

  3230.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;Deprecated since v1.3.1&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3231. 

  3231.   <dd>
    3232. 

  3232.     <div class="deprecation-message">
    3233. 

  3233.   <b>Deprecated:</b> Deprecated since v1.3.1
    3234. 

  3234. </div>
    3235. 

  3235. 

  3236.     
    3237. 

  3237.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2896" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3238. 

  3238. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2896" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3239. 

  3239. 

  3240.   </dd>
    3241. 

  3241. </div>
    3242. 

  3242. 

  3243. </div>
    3244. 

  3244. <div id="weekday-procs-all">
    3245. 

  3245.   <div id="weekday,DateTime">
    3246. 

  3246.   <dt><pre><span class="Keyword">proc</span> <a href="#weekday%2CDateTime"><span class="Identifier">weekday</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#WeekDay"><span class="Identifier">WeekDay</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3247. 

  3247.   <dd>
    3248. 

  3248.     
    3249. 

  3249.     The day of the week as an enum, the ordinal value is in the range 0 (monday) to 6 (sunday).
    3250. 

  3250.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1099" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3251. 

  3251. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1099" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3252. 

  3252. 

  3253.   </dd>
    3254. 

  3254. </div>
    3255. 

  3255. 

  3256. </div>
    3257. 

  3257. <div id="weekday=-procs-all">
    3258. 

  3258.   <div id="weekday=,DateTime,WeekDay">
    3259. 

  3259.   <dt><pre><span class="Keyword">proc</span> <a href="#weekday%3D%2CDateTime%2CWeekDay"><span class="Identifier">weekday=</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">;</span> <span class="Identifier">value</span><span class="Other">:</span> <a href="times.html#WeekDay"><span class="Identifier">WeekDay</span></a><span class="Other">)</span> {.
    3260. 

  3260.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;Deprecated since v1.3.1&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3261. 

  3261.   <dd>
    3262. 

  3262.     <div class="deprecation-message">
    3263. 

  3263.   <b>Deprecated:</b> Deprecated since v1.3.1
    3264. 

  3264. </div>
    3265. 

  3265. 

  3266.     
    3267. 

  3267.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2884" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3268. 

  3268. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2884" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3269. 

  3269. 

  3270.   </dd>
    3271. 

  3271. </div>
    3272. 

  3272. 

  3273. </div>
    3274. 

  3274. <div id="weeks-procs-all">
    3275. 

  3275.   <div id="weeks,int">
    3276. 

  3276.   <dt><pre><span class="Keyword">proc</span> <a href="#weeks%2Cint"><span class="Identifier">weeks</span></a><span class="Other">(</span><span class="Identifier">w</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3277. 

  3277.   <dd>
    3278. 

  3278.     
    3279. 

  3279.     <p>TimeInterval of <tt class="docutils literal"><span class="pre"><span class="Identifier">w</span></span></tt> weeks.</p>
    3280. 

  3280. <p><tt class="docutils literal"><span class="pre"><span class="Identifier">echo</span> <span class="Identifier">getTime</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">+</span> <span class="FloatNumber">2.</span><span class="Identifier">weeks</span></span></tt></p>
    3281. 

  3281. 

  3282.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2622" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3283. 

  3283. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2622" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3284. 

  3284. 

  3285.   </dd>
    3286. 

  3286. </div>
    3287. 

  3287. 

  3288. </div>
    3289. 

  3289. <div id="year-procs-all">
    3290. 

  3290.   <div id="year,DateTime">
    3291. 

  3291.   <dt><pre><span class="Keyword">proc</span> <a href="#year%2CDateTime"><span class="Identifier">year</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3292. 

  3292.   <dd>
    3293. 

  3293.     
    3294. 

  3294.     The year, using astronomical year numbering (meaning that before year 1 is year 0, then year -1 and so on).
    3295. 

  3295.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1092" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3296. 

  3296. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1092" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3297. 

  3297. 

  3298.   </dd>
    3299. 

  3299. </div>
    3300. 

  3300. 

  3301. </div>
    3302. 

  3302. <div id="year=-procs-all">
    3303. 

  3303.   <div id="year=,DateTime,int">
    3304. 

  3304.   <dt><pre><span class="Keyword">proc</span> <a href="#year%3D%2CDateTime%2Cint"><span class="Identifier">year=</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">;</span> <span class="Identifier">value</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span> {.
    3305. 

  3305.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;Deprecated since v1.3.1&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3306. 

  3306.   <dd>
    3307. 

  3307.     <div class="deprecation-message">
    3308. 

  3308.   <b>Deprecated:</b> Deprecated since v1.3.1
    3309. 

  3309. </div>
    3310. 

  3310. 

  3311.     
    3312. 

  3312.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2881" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3313. 

  3313. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2881" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3314. 

  3314. 

  3315.   </dd>
    3316. 

  3316. </div>
    3317. 

  3317. 

  3318. </div>
    3319. 

  3319. <div id="yearday-procs-all">
    3320. 

  3320.   <div id="yearday,DateTime">
    3321. 

  3321.   <dt><pre><span class="Keyword">proc</span> <a href="#yearday%2CDateTime"><span class="Identifier">yearday</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#YeardayRange"><span class="Identifier">YeardayRange</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    3322. 

  3322.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3323. 

  3323.   <dd>
    3324. 

  3324.     
    3325. 

  3325.     The number of days since January 1, in the range 0 to 365.
    3326. 

  3326.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1105" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3327. 

  3327. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1105" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3328. 

  3328. 

  3329.   </dd>
    3330. 

  3330. </div>
    3331. 

  3331. 

  3332. </div>
    3333. 

  3333. <div id="yearday=-procs-all">
    3334. 

  3334.   <div id="yearday=,DateTime,YeardayRange">
    3335. 

  3335.   <dt><pre><span class="Keyword">proc</span> <a href="#yearday%3D%2CDateTime%2CYeardayRange"><span class="Identifier">yearday=</span></a><span class="Other">(</span><span class="Identifier">dt</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="times.html#DateTime"><span class="Identifier">DateTime</span></a><span class="Other">;</span> <span class="Identifier">value</span><span class="Other">:</span> <a href="times.html#YeardayRange"><span class="Identifier">YeardayRange</span></a><span class="Other">)</span> {.
    3336. 

  3336.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">deprecated</span><span class="Other">:</span> <span class="StringLit">&quot;Deprecated since v1.3.1&quot;</span><span class="Other">,</span> <span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3337. 

  3337.   <dd>
    3338. 

  3338.     <div class="deprecation-message">
    3339. 

  3339.   <b>Deprecated:</b> Deprecated since v1.3.1
    3340. 

  3340. </div>
    3341. 

  3341. 

  3342.     
    3343. 

  3343.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2887" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3344. 

  3344. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2887" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3345. 

  3345. 

  3346.   </dd>
    3347. 

  3347. </div>
    3348. 

  3348. 

  3349. </div>
    3350. 

  3350. <div id="years-procs-all">
    3351. 

  3351.   <div id="years,int">
    3352. 

  3352.   <dt><pre><span class="Keyword">proc</span> <a href="#years%2Cint"><span class="Identifier">years</span></a><span class="Other">(</span><span class="Identifier">y</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#TimeInterval"><span class="Identifier">TimeInterval</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3353. 

  3353.   <dd>
    3354. 

  3354.     
    3355. 

  3355.     <p>TimeInterval of <tt class="docutils literal"><span class="pre"><span class="Identifier">y</span></span></tt> years.</p>
    3356. 

  3356. <p><tt class="docutils literal"><span class="pre"><span class="Identifier">echo</span> <span class="Identifier">getTime</span><span class="Punctuation">(</span><span class="Punctuation">)</span> <span class="Operator">+</span> <span class="FloatNumber">2.</span><span class="Identifier">years</span></span></tt></p>
    3357. 

  3357. 

  3358.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L2634" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3359. 

  3359. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L2634" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3360. 

  3360. 

  3361.   </dd>
    3362. 

  3362. </div>
    3363. 

  3363. 

  3364. </div>
    3365. 

  3365. <div id="zonedTimeFromAdjTime-procs-all">
    3366. 

  3366.   <div id="zonedTimeFromAdjTime,Timezone,Time">
    3367. 

  3367.   <dt><pre><span class="Keyword">proc</span> <a href="#zonedTimeFromAdjTime%2CTimezone%2CTime"><span class="Identifier">zonedTimeFromAdjTime</span></a><span class="Other">(</span><span class="Identifier">zone</span><span class="Other">:</span> <a href="times.html#Timezone"><span class="Identifier">Timezone</span></a><span class="Other">;</span> <span class="Identifier">adjTime</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#ZonedTime"><span class="Identifier">ZonedTime</span></a> {.
    3368. 

  3368.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3369. 

  3369.   <dd>
    3370. 

  3370.     
    3371. 

  3371.     <p>Returns the <tt class="docutils literal"><span class="pre"><span class="Identifier">ZonedTime</span></span></tt> for some local time.</p>
    3372. 

  3372. <p>Note that the <tt class="docutils literal"><span class="pre"><span class="Identifier">Time</span></span></tt> argument does not represent a point in time, it represent a local time! E.g if <tt class="docutils literal"><span class="pre"><span class="Identifier">adjTime</span></span></tt> is <tt class="docutils literal"><span class="pre"><span class="Identifier">fromUnix</span><span class="Punctuation">(</span><span class="DecNumber">0</span><span class="Punctuation">)</span></span></tt>, it should be interpreted as 1970-01-01T00:00:00 in the <tt class="docutils literal"><span class="pre"><span class="Identifier">zone</span></span></tt> timezone, not in UTC.</p>
    3373. 

  3373. 

  3374.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1241" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3375. 

  3375. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1241" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3376. 

  3376. 

  3377.   </dd>
    3378. 

  3378. </div>
    3379. 

  3379. 

  3380. </div>
    3381. 

  3381. <div id="zonedTimeFromTime-procs-all">
    3382. 

  3382.   <div id="zonedTimeFromTime,Timezone,Time">
    3383. 

  3383.   <dt><pre><span class="Keyword">proc</span> <a href="#zonedTimeFromTime%2CTimezone%2CTime"><span class="Identifier">zonedTimeFromTime</span></a><span class="Other">(</span><span class="Identifier">zone</span><span class="Other">:</span> <a href="times.html#Timezone"><span class="Identifier">Timezone</span></a><span class="Other">;</span> <span class="Identifier">time</span><span class="Other">:</span> <a href="times.html#Time"><span class="Identifier">Time</span></a><span class="Other">)</span><span class="Other">:</span> <a href="times.html#ZonedTime"><span class="Identifier">ZonedTime</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    3384. 

  3384.     <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    3385. 

  3385.   <dd>
    3386. 

  3386.     
    3387. 

  3387.     Returns the <tt class="docutils literal"><span class="pre"><span class="Identifier">ZonedTime</span></span></tt> for some point in time.
    3388. 

  3388.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/times.nim#L1237" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    3389. 

  3389. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/times.nim#L1237" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    3390. 

  3390. 

  3391.   </dd>
    3392. 

  3392. </div>
    3393. 

  3393. 

  3394. </div>
    3395. 

  3395. 

  3396.   </dl>
    3397. 

  3397. </div>
    3398. 

  3398. 

  3399.   </div>
    3400. 

  3400. </div>
    3401. 

  3401. 

  3402.       <div class="twelve-columns footer">
    3403. 

  3403.         <span class="nim-sprite"></span>
    3404. 

  3404.         <br>
    3405. 

  3405.         <small style="color: var(--hint);">Made with Nim. Generated: 2025-01-09 12:00:09 UTC</small>
    3406. 

  3406.       </div>
    3407. 

  3407.     </div>
    3408. 

  3408.   </div>
    3409. 

  3409.       <script defer data-domain="nim-lang.org" src="https://plausible.io/js/plausible.js"></script>
    3410. 

  3410.     
    3411. 

  3411. </body>
    3412. 

  3412. </html>
    3413. 

  3413.