自分のライブラリを1年運用をして見た振り返りと知見
•
0 likes•1,922 views
Otemachi.swift x Kyobashi.swift #01での登壇資料になります。 日本の祝祭日判定を計算ロジックだけで行うライブラリ、「CalculateCalendarLogic」を1年前から開発し今日まで運用した際のことをまとめました。 判定が難しい部分のロジック及びテストコードの組み立て方針などを中心に解説しています。 Github: https://github.com/fumiyasac/handMadeCalendarAdvance 開発当時のQiita記事： http://qiita.com/fumiyasac@github/items/33bfc07ad36dfffcdf8f ※今後と改善は継続していきますので、よろしくお願い致します。
Recommended
More Related Content
What's hot
What's hot (20)
More from Fumiya Sakai
More from Fumiya Sakai (20)
Recently uploaded
Recently uploaded (9)
自分のライブラリを1年運用をして見た振り返りと知見
- 8. public func judgeJapaneseHoliday(year: Int, month: Int, day: Int) -> Bool { /// 国民の祝日に関する法律（こくみんのしゅくじつにかんするほうりつ）は、 /// 1948年（昭和23年）7月20日に公布・即日施行された日本の法律である。通称祝日法。 /// See also: https://ja.wikipedia.org/wiki/国民の祝日に関する律 /// 「国民の祝日」が日曜日に当たるときは、その日後においてその日に最も近い「国民の祝日」でない日を休日とする /// 1973年の国民の祝日に関する法律が改正されたことにより制定 /// See also: https://ja.wikipedia.org/wiki/%E6%8C%AF%E6%9B%BF%E4%BC%91%E6%97%A5 /// （注意）春分の日・秋分の日は1948年以前も祝祭日であったが、このカレンダーロジックの基準は1948年〜を基準とするので考慮しない /// See also: https://ja.wikipedia.org/wiki/%E7%9A%87%E9%9C%8A%E7%A5%AD switch (year, month, day, weekday) { /// 例）海の日の場合 //(1).7月20日(1996年から2002年まで)、(2).7月の第3月曜日(2003年から): 海の日 case (1996...2002, 7, 20, _): return true //(2).7月の第3月曜日(2003年から): 海の日 case (year, 7, 15...21, .mon) where 2003 <= year: return true //7月21日: 海の日の振替休日 case (1996...2002, 7, 21, .mon): return true タプルでの条件分岐を活用し、条件指定を整理 ✦ N月の第M週となるロジック部分と振替休日になる部分の実装 第M週のロジックに関してはカレンダーで取りうる値の範囲が決まる＆月曜日であることをチェックする。 ★振替休日＆ハッピーマンデー制度の施行前＆施行後の考慮してロジックにする 祝祭日判定でのポイント（ハッピーマンデー制度） 参考： 2000年〜 ・成人の日 → 1月第2月曜日 ・体育の日 → 10月第2月曜日 2003年〜 ・海の日 → 7月第3月曜日 ・敬老の日 → 9月第3月曜日
- 9. ✦ 春分・秋分は計算式を用いて算出する方針 上記のように日付が年によってずれる部分なのでシルバーウィーク同様に気がつきにくい部分なので注意。 ★春分の日は（3/20 or 3/21）になり、秋分の日は（9/22 or 9/23）になる 祝祭日判定でのポイント（春分・秋分） private enum SpringAutumn { /// 春分の日 case spring /// 秋分の日 case autumn var constant: Double { switch self { case .spring: return 20.69115 case .autumn: return 23.09000 } } /// 春分の日・秋分の日を計算する /// 参考：http://koyomi8.com/reki_doc/doc_0330.htm func calcDay(year: Int) -> Int { let x1: Double = Double(year - 2000) * 0.242194 let x2: Int = Int(Double(year - 2000) / 4) return Int(constant + x1 - Double(x2)) } } //3月20日 or 21日: 春分の日(計算値によって算出) case (year, 3, day, _) where PublicHolidaysLawYear < year && day == SpringAutumn.spring.calcDay(year: year): return true //春分の日の次が月曜日: 振替休日 case (year, 3, day, .mon) where year >= AlternateHolidaysLawYear && day == SpringAutumn.spring.calcDay(year: year) + 1: return true //9月22日 or 23日: 秋分の日(計算値によって算出) case (year, 9, day, _) where PublicHolidaysLawYear <= year && day == SpringAutumn.autumn.calcDay(year: year): return true //秋分の日の次が月曜日: 振替休日 case (year, 9, day, .mon) where year >= AlternateHolidaysLawYear && day == SpringAutumn.autumn.calcDay(year: year) + 1: return true 春分点・秋分点のずれを考慮 テストケース 2000年以降は、 担保できるように 計算ロジックに反映する
- 10. //(1).9月15日(1966年から2002年まで)、(2).9月の第3月曜日(2003年から): 敬老の日 case (1966...2002, 9, 15, _): return true case (year, 9, 15...21, .mon) where year > 2002: return true //9月16日: 敬老の日の振替休日 case (1973...2002, 9, 16, .mon): return true //9月22日 or 23日: 秋分の日(計算値によって算出) case (year, 9, day, _) where PublicHolidaysLawYear <= year && day == SpringAutumn.autumn.calcDay(year: year): return true //秋分の日の次が月曜日: 振替休日 case (year, 9, day, .mon) where year >= AlternateHolidaysLawYear && day == SpringAutumn.autumn.calcDay(year: year) + 1: return true //シルバーウィークの振替休日である(※現行の法律改正から変わらないと仮定した場合2009年から発生する) //See also: https://ja.wikipedia.org/wiki/シルバーウィーク case (_, 9, _, _) where oldPeopleDay(year: year) < day && day < SpringAutumn.autumn.calcDay(year: year) && getAlterHolidaySliverWeek(year: year) && year > 2008: return true 国民の祝日の判定 ✦ 9月に国民の祝日が重なって5連休になる場合のロジック実装 シルバーウィークの判定は敬老の日と秋分の日＆国民の祝日になる条件が重なるので気がつきにくい部分。 ★敬老の日の2日後が秋分の日ならば間に挟まれた期間は国民の休日とする 祝祭日判定でのポイント（シルバーウィーク） 歴代シルバーウィーク： 2009年, 2015年に発生 次は「2026年」になります。 敬老の日が9月第3月曜になった影響 /** *� *�シルバーウィークの振替休日を判定する *�敬老の日の2日後が秋分の日ならば間に挟まれた期間は国民の休日とする * */ private func getAlterHolidaySliverWeek(year: Int) -> Bool { return oldPeopleDay(year: year) + 2 == SpringAutumn.autumn.calcDay(year: year) }
- 12. ✦ 特に難易度が高そう＆紛らわしそうな部分は手厚くする UIに組み込んだサンプルだけでなく最初は拙い感じでもコードだけでなく徐々に改善を定期的に加える。 ★ここではシルバーウィークに関する例を見てみる（5連休になっているか） ユニットテストのコード例（XCTestでの記載例） /** * シルバーウィークの判定のテスト */ func testSilverWeek() { let test = CalculateCalendarLogic() let testCases: [(Int,Int,Int,Bool)] = [ // 2015年 (2015, 9, 19, false), (2015, 9, 20, false), (2015, 9, 21, true), (2015, 9, 22, true), (2015, 9, 23, true), (2015, 9, 24, false), // 2016年 (2016, 9, 19, true), (2016, 9, 20, false), (2016, 9, 21, false), (2016, 9, 22, true), (2016, 9, 23, false), (2016, 9, 24, false), ] testCases.forEach { year, month, day, expected in let result = test.judgeJapaneseHoliday(year: year, month: month, day: day) guard let weekday = Weekday(year: year, month: month, day: day) else { XCTFail() ; return } let message = "(year)年(month)月(day)日（(weekday.longName)）：(result)" if expected { XCTAssertTrue (result, message) } else { XCTAssertFalse(result, message) } } } 2015年：○, 2016年× シルバーウィークか否かの判定 紛らわしい判定をするテストケースがあるとGood! 少しずつ怪しいテストケースを追加 テストコード＆ドキュメントも加筆する いきなりではなく徐々に改善： 現在から前後10年ぐらいは担保したい：