cronstrue 1.125.0 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (95) hide show
  1. package/README.md +17 -7
  2. package/dist/cronstrue-i18n.js +3774 -3821
  3. package/dist/cronstrue-i18n.min.js +1 -1
  4. package/dist/cronstrue.js +392 -438
  5. package/dist/cronstrue.min.js +1 -1
  6. package/dist/expressionDescriptor.d.ts +4 -3
  7. package/dist/i18n/locale.d.ts +4 -4
  8. package/dist/i18n/locales/be.d.ts +4 -4
  9. package/dist/i18n/locales/ca.d.ts +4 -4
  10. package/dist/i18n/locales/cs.d.ts +4 -4
  11. package/dist/i18n/locales/da.d.ts +4 -4
  12. package/dist/i18n/locales/de.d.ts +4 -4
  13. package/dist/i18n/locales/en.d.ts +4 -4
  14. package/dist/i18n/locales/es.d.ts +4 -4
  15. package/dist/i18n/locales/fa.d.ts +4 -4
  16. package/dist/i18n/locales/fi.d.ts +4 -4
  17. package/dist/i18n/locales/fr.d.ts +4 -4
  18. package/dist/i18n/locales/he.d.ts +4 -4
  19. package/dist/i18n/locales/id.d.ts +4 -4
  20. package/dist/i18n/locales/it.d.ts +4 -4
  21. package/dist/i18n/locales/ja.d.ts +4 -4
  22. package/dist/i18n/locales/ko.d.ts +4 -4
  23. package/dist/i18n/locales/nb.d.ts +4 -4
  24. package/dist/i18n/locales/nl.d.ts +4 -4
  25. package/dist/i18n/locales/pl.d.ts +4 -4
  26. package/dist/i18n/locales/pt_BR.d.ts +4 -4
  27. package/dist/i18n/locales/ru.d.ts +4 -4
  28. package/dist/i18n/locales/sk.d.ts +4 -4
  29. package/dist/i18n/locales/sl.d.ts +4 -4
  30. package/dist/i18n/locales/sv.d.ts +4 -4
  31. package/dist/i18n/locales/sw.d.ts +4 -4
  32. package/dist/i18n/locales/tr.d.ts +4 -4
  33. package/dist/i18n/locales/uk.d.ts +4 -4
  34. package/dist/i18n/locales/zh_CN.d.ts +4 -4
  35. package/dist/i18n/locales/zh_TW.d.ts +4 -4
  36. package/dist/options.d.ts +1 -1
  37. package/locales/be.js +1 -0
  38. package/locales/be.min.js +1 -0
  39. package/locales/ca.js +1 -0
  40. package/locales/ca.min.js +1 -0
  41. package/locales/cs.js +1 -0
  42. package/locales/cs.min.js +1 -0
  43. package/locales/da.js +1 -0
  44. package/locales/da.min.js +1 -0
  45. package/locales/de.js +1 -0
  46. package/locales/de.min.js +1 -0
  47. package/locales/en.js +1 -0
  48. package/locales/en.min.js +1 -0
  49. package/locales/es.js +1 -0
  50. package/locales/es.min.js +1 -0
  51. package/locales/fa.js +1 -0
  52. package/locales/fa.min.js +1 -0
  53. package/locales/fi.js +1 -0
  54. package/locales/fi.min.js +1 -0
  55. package/locales/fr.js +1 -0
  56. package/locales/fr.min.js +1 -0
  57. package/locales/he.js +1 -0
  58. package/locales/he.min.js +1 -0
  59. package/locales/id.js +1 -0
  60. package/locales/id.min.js +1 -0
  61. package/locales/it.js +1 -0
  62. package/locales/it.min.js +1 -0
  63. package/locales/ja.js +1 -0
  64. package/locales/ja.min.js +1 -0
  65. package/locales/ko.js +1 -0
  66. package/locales/ko.min.js +1 -0
  67. package/locales/nb.js +1 -0
  68. package/locales/nb.min.js +1 -0
  69. package/locales/nl.js +1 -0
  70. package/locales/nl.min.js +1 -0
  71. package/locales/pl.js +1 -0
  72. package/locales/pl.min.js +1 -0
  73. package/locales/pt_BR.js +1 -0
  74. package/locales/pt_BR.min.js +1 -0
  75. package/locales/ro.js +1 -0
  76. package/locales/ro.min.js +1 -0
  77. package/locales/ru.js +1 -0
  78. package/locales/ru.min.js +1 -0
  79. package/locales/sk.js +1 -0
  80. package/locales/sk.min.js +1 -0
  81. package/locales/sl.js +1 -0
  82. package/locales/sl.min.js +1 -0
  83. package/locales/sv.js +1 -0
  84. package/locales/sv.min.js +1 -0
  85. package/locales/sw.js +1 -0
  86. package/locales/sw.min.js +1 -0
  87. package/locales/tr.js +1 -0
  88. package/locales/tr.min.js +1 -0
  89. package/locales/uk.js +1 -0
  90. package/locales/uk.min.js +1 -0
  91. package/locales/zh_CN.js +1 -0
  92. package/locales/zh_CN.min.js +1 -0
  93. package/locales/zh_TW.js +1 -0
  94. package/locales/zh_TW.min.js +1 -0
  95. package/package.json +9 -8
package/README.md CHANGED
@@ -99,23 +99,33 @@ An options object can be passed as the second parameter to `cronstrue.toString`.
99
99
 
100
100
  ## i18n
101
101
 
102
- To use the i18n support cRonstrue provides, you must use the packaged library that contains the locale translations. Once you do this, you can pass the name of a supported locale as an option to `cronstrue.toString()`. For example, for the es (Spanish) locale, you would use: `cronstrue.toString("* * * * *", { locale: "es" });`.
102
+ To use the i18n support cRonstrue provides, you can import a specific locale and then call `toString()`. For example, for the es (Spanish) locale:
103
103
 
104
- ### Node
105
104
  ```js
106
- var cronstrue = require('cronstrue/i18n');
107
- cronstrue.toString("*/5 * * * *", { locale: "fr" });
105
+ import cronstrue from 'cronstrue/locales/es';
106
+ cronstrue.toString("*/5 * * * *");
108
107
  ```
108
+
109
109
  ### Browser
110
- The `cronstrue-i18n.min.js` file from the `/dist` folder in the npm package should be served to the browser.
110
+
111
+ A locale file from the `/locales` folder in the npm package should be served to the browser.
111
112
 
112
113
  ```html
113
- <script src="cronstrue-i18n.min.js" type="text/javascript"></script>
114
+ <script src="https://unpkg.com/cronstrue@latest/locales/es.min.js" async></script>
114
115
  <script>
115
- cronstrue.toString("*/5 * * * *", { locale: "fr" });
116
+ cronstrue.toString("*/5 * * * *");
116
117
  </script>
117
118
  ```
118
119
 
120
+ ## All Locales
121
+
122
+ Alternatively you can import all locales and then pass in the `locale` option:
123
+
124
+ ```js
125
+ import cronstrue from 'cronstrue/i18n';
126
+ cronstrue.toString("*/5 * * * *", { locale: "es" });
127
+ ```
128
+
119
129
  ## Frequently Asked Questions
120
130
 
121
131
  > The cron expression I am passing in is not valid and this library is giving strange output. What should I do?