{"id":19013353,"url":"https://github.com/z41z/sp-data","last_synced_at":"2025-06-15T03:02:49.109Z","repository":{"id":32839671,"uuid":"144128490","full_name":"z41z/sp-data","owner":"z41z","description":"Common Data Trans methods for Date, Array, Object, Array of Objects etc.","archived":false,"fork":false,"pushed_at":"2022-12-05T12:30:02.000Z","size":345,"stargazers_count":0,"open_issues_count":10,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-05-27T07:46:42.257Z","etag":null,"topics":["array","array-of-objects-sort","arraysort","boolean","date","dateformat","frontend","javascript","jsdate","parse","sort","unique-array"],"latest_commit_sha":null,"homepage":"https://z41z.github.io/sp-data/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/z41z.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-08-09T09:09:16.000Z","updated_at":"2020-04-07T00:11:30.000Z","dependencies_parsed_at":"2023-01-14T22:23:59.904Z","dependency_job_id":null,"html_url":"https://github.com/z41z/sp-data","commit_stats":null,"previous_names":["r3qu3stt1me0ut/sp-fe","z41z/sp-fe-data"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/z41z/sp-data","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/z41z%2Fsp-data","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/z41z%2Fsp-data/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/z41z%2Fsp-data/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/z41z%2Fsp-data/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/z41z","download_url":"https://codeload.github.com/z41z/sp-data/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/z41z%2Fsp-data/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259914867,"owners_count":22931323,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["array","array-of-objects-sort","arraysort","boolean","date","dateformat","frontend","javascript","jsdate","parse","sort","unique-array"],"created_at":"2024-11-08T19:23:35.638Z","updated_at":"2025-06-15T03:02:49.088Z","avatar_url":"https://github.com/z41z.png","language":"JavaScript","readme":"# sp-data\n\nCommon Data Trans methods for Date, Array, Object, Array of Objects etc.\n\n***\n\n## Install\n\n### NPM\n\n``` node\nnpm install --save sp-data\n// or yarn add sp-data\n```\n\n### CDN\n\n```html\n\u003cscript src=\"https://unpkg.com/sp-data/index.min.js\"\u003e\u003c/script\u003e\n\u003cscript\u003e\n  __DATA.array.create(5, 0);\n  //=\u003e [0, 0, 0, 0, 0]\n\u003c/script\u003e\n```\n\n***\n\n## Usage\n\n```js\n //sp: {date, array, object, parse, entity, string}\nconst sp = require('sp-data');\n\nsp.date.format('yyyy-MM-dd', new Date());\n//=\u003e 2018-08-06\n\nsp.array.sort(arr = [1, 2, 3, 4, 1], isASC = true)\n//=\u003e[1, 1, 2, 3, 4]\n\nsp.array.sort(arr = [1, 2, 3, 4, 1], isASC = false)\n//=\u003e[4, 3, 2, 1, 1]\n```\n\n### Date\n\n```js\n//date: format(), goto(), prevDay(), prevMonth(), prevYear(), nextDay(), nextMonth(), nextYear(), calc()\nconst date = require('sp-data/date');\n\ndate.format('yyyy-MM-dd', new Date());\n//=\u003e 2018-08-06\n\ndate.goto(year, month, day);\n//=\u003e return Date\n\ndate.prevDay(dayCount = 0, startDate = new Date());\n//=\u003e return Date\n\ndate.prevMonth(monthCount = 0, date = new Date());\n//=\u003e return Date\n\ndate.prevYear(yearCount = 0, date = new Date());\n//=\u003e return Date\n\ndate.nextDay(dayCount = 0, startDate = new Date());\n//=\u003e return Date\n\ndate.nextMonth(monthCount = 0, date = new Date());\n//=\u003e return Date\n\ndate.nextYear(yearCount = 0, date = new Date());\n//=\u003e return Date\n\ndate.calc(startDate = new Date(2018, 01, 01), endDate = new Date());\n//=\u003e { seconds: 20, minutes: 44, hours: 15, days: 188 }\n\ndate.calc(startDate = new Date(2018, 01, 01), endDate = new Date(2000, 01, 01));\n//=\u003e { seconds: 0, minutes: 0, hours: 0, days: 6575 }\n\n```\n\n### Array \u0026\u0026 Array of Objects\n\n```js\n //arr: create(), sort(), sortObj(), unique(), uniqueObj(), filter(), sum(), createByArrObj(), mergeObj()\nconst arr = require('sp-data/array');\n\narr.create((length = 5, fillVal = 'a'))\n//=\u003e['a', 'a', 'a', 'a', 'a']\n\narr.sort(arr = [1, 2, 3, 4, 1], isASC = true)\n//=\u003e[1, 1, 2, 3, 4]\n\narr.sort(arr = [1, 2, 3, 4, 1], isASC = false)\n//=\u003e[4, 3, 2, 1, 1]\n\narr.sortObj(arr = [{name: 'Alice', age: 12},{name: 'Bob', age: 14}, {name: 'John', age: 11}], keyName = 'age', isASC = true)\n//=\u003e[{name: 'John', age: 11}, {name: 'Alice', age: 12},{name: 'Bob', age: 14}]\n\narr.sortObj(arr = [{name: 'Alice', age: 12},{name: 'Bob', age: 14}, {name: 'John', age: 11}], keyName = 'age', isASC = false)\n//=\u003e[{name: 'Bob', age: 14}, {name: 'Alice', age: 12}, {name: 'John', age: 11}]\n\narr.unique(arr = [1, 2, 3, 4, 1])\n//=\u003e[1, 2, 3, 4]\n\n//unique by all key\narr.uniqueObj(arr = [{a: 1, b: 2}, {a: 2, b: 3}, {a: 1}, {a: 1}])\n//=\u003e[{a: 1, b: 2}, {a: 2, b: 3}, {a: 1}]\n\n//unique by key name\narr.uniqueObj(arr = [{a: 1, b: 2}, {a: 2, b: 3}, {a: 1}], keyName = 'a')\n//=\u003e[{a: 1, b: 2}, {a: 2, b: 3}]\n\narr.filter(arr = [1, 3, 4, 5], function(item) {return item \u003e 3;})\n//=\u003e[4, 5]\n\narr.filter(arr = [{name: 'Alice', age: 12},{name: 'Bob', age: 14}, {name: 'John', age: 11}], function(item) {return item.age \u003e 12;})\n//=\u003e[{name: 'Bob', age: 14}]\n\narr.sum(arr = [1, 2, 3])\n//=\u003e6\n\n//item is NOT number string return 0\narr.sum(arr = [1, 2, 3, 'a', 'b'])\n//=\u003e6\n\n//sum by index =\u003e value\narr.sum(arr = [[1, 2, 3], [4, 5, 6], [7, 8], [9]], idDeep = true)\n//[1 + 4 + 7 + 9, 2 + 5 + 8, 9]\n//=\u003e[ 21, 15, 9]\n\n//sum by key =\u003e value\narr.sum(arr = [{a: 1, b: 2, c: 3}, {a: 4, b: 5}, {c: 6}, {d: 7}], idDeep = true)\n//[{a: 1 + 4, b: 2 + 5, c: 3 + 6, d: 7}]\n//=\u003e[ { a: 5, b: 7, c: 9, d: 7 } ]\n\narr.createByArrObj(arrObj = [ { a: 3, b: 7}, {a: 0, b: 3}, {a: 2, b: 4} ], indexName = 'a', valueName = 'b')\n//=\u003e[ 3, 0, 4 ]\n\narr.createByArrObj(arrObj = [ { a: 3, b: 7},{a: 0, b: 3}, {a: 2, b: 4} ], indexName = 'a', valueName = 'b', length = 6)\n//=\u003e[ 3, 0, 4, 7, 0, 0 ]\n\narr.createByArrObj(arrObj = [ { a: 3, b: 7}, {a: 0, b: 3}, {a: 2, b: 4} ], indexName = 'a', valueName = 'b', length = 6, defaultValue = 666)\n//=\u003e[ 3, 666, 4, 7, 666, 666 ]\n\nlet src = [{city:'city1',total:0},{city:'city2',total:0}]\nlet dest = [{city:'city1',total:10},{city:'city2',total:0}]\narr.mergeObj(src,mergeName = 'city', dest)\n//=\u003e [{city:'city1',total:10},{city:'city2',total:0}]\n```\n\n### Object\n\n```js\n//obj: reverse(), rename()\nconst obj = require('sp-data/object');\n\nobj.reverse(obj = {a: 1, b: 2})\n//=\u003e {1: a, 2: b}\n\nobj.reverse(obj = {a: 1, b: 2}, keyName = 'a')\n//=\u003e {1: a, b: 2}\n\nobj.reverse(obj = [{a: 1, b: 2}, {a: 2, b: 3, d: 5}])\n//=\u003e [ { '1': 'a', '2': 'b' }, { '2': 'a', '3': 'b', '5': 'd' } ]\n\n//last value will be the last key\nobj.reverse(obj = [{a: 1, b: 2}, {a: 2, b: 3, c: 5, d: 5, e: 5}])\n//=\u003e[ { '1': 'a', '2': 'b' }, { '2': 'a', '3': 'b', '5': 'e' } ]\n\nobj.reverse(obj = [{a: 1, b: 2}, {a: 2, b: 3, d: 5}], keyName = 'a')\n//=\u003e [ { '1': 'a', b: 2 }, { '2': 'a', b: 3, d: 5 } ]\n\n//Object {}\nobj.rename(obj = { a: 2, b: 3, c: 5, d: 5, e: 5 })\n//=\u003e{ a: 2, b: 3, c: 5, d: 5, e: 5 }\n\nobj.rename(obj = { a: 2, b: 3, c: 5, d: 5, e: 5 }, target = 'a')\n//=\u003e{b: 3, c: 5, d: 5, e: 5 }\n\nobj.rename(obj = { a: 2, b: 3, c: 5, d: 5, e: 5 }, target = 'a', replacer = 'x')\n//=\u003e{x:2, b: 3, c: 5, d: 5, e: 5 }\n\n//Array of Objects\nobj.rename(obj = [{ a: 2, b: 3}, {a: 3, b: 5}])\n//=\u003e[{ a: 2, b: 3}, {a: 3, b: 5}]\n\nobj.rename(obj = [{ a: 2, b: 3}, {a: 3, b: 5}], 'a')\n//=\u003e[{b: 3}, {b: 5}\n\nobj.rename(obj = [{ a: 2, b: 3, c: 4}, {a: 3, b: 5}], 'c', 'x')\n//=\u003e[{ a: 2, b: 3, x: 4}, {a: 3, b: 5}]\n```\n\n### Parse\n\n```js\n//parse: number(), bollean()\nconst parse = require('sp-data/parse');\n\n//undefined, [] ,{} ,NaN ,'' ,' ', null or not number string return 0\nparse.number(num = [], fixedLength = 0)\n//=\u003e 0\n\nparse.number(num = {}, fixedLength = 2)\n//=\u003e 0.00\n\nparse.number(num = 'a', fixedLength = 2)\n//=\u003e 0.00\n\nparse.number(num = '2', fixedLength = 2)\n//=\u003e 2.00\n\nparse.number(num = '2.000', fixedLength = 2)\n//=\u003e 2.00\n\n//undefined, [] ,{} ,NaN ,'' ,' ', null return false\nparse.boolean(0)\n//=\u003e false\n\n//undefined, [] ,{} ,NaN ,'' ,' ', null return false\nparse.boolean('a')\n//=\u003e true\n```\n\n\n### entity\n```js\n//entity: encode(str), decode(str)\nconst entity = require('sp-data/entity');\nentity.encode('1')\n// \u0026#49;\nentity.decode('\u0026#49;\u0026#50;\u0026#51;')\n// 123\n```\n\n### string\n```js\n//entity: encode(str), decode(str)\nconst string = require('sp-data/string')\nstring.replace('你我他',{你:'ni',我:'wo'})\n// niwo他\n```\n## License\n\nMIT\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fz41z%2Fsp-data","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fz41z%2Fsp-data","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fz41z%2Fsp-data/lists"}