日本の祝祭日を計算してカレンダ－に表示するアプリサンプル
•
0 recomendaciones•1,786 vistas
集まれSwift好き！Swift愛好会 #7での発表資料になります。 日本の祝祭日を判定するライブラリを作成しました。そのロジックを実装する過程で得た知見や気を付けたポイント等をまとめました。 （詳細解説）日本の祝祭日を計算してカレンダ－に表示するアプリサンプル http://qiita.com/fumiyasac@github/items/33bfc07ad36dfffcdf8f （サンプルリポジトリ） https://github.com/fumiyasac/handMadeCalendarAdvance
Recomendados
Más contenido relacionado
La actualidad más candente
La actualidad más candente (20)
Destacado
Más de Fumiya Sakai
Más de Fumiya Sakai (20)
Último
Último (11)
日本の祝祭日を計算してカレンダ－に表示するアプリサンプル
- 9. ✦ 条件分岐にタプルを使用して複数の引数をひとまとめにする 判定ロジックの見通しを良くする工夫 switch文での判定対象にタプルを設定できるのでwhere句を組み合わせてロジックの見通しを良くしている。 ★case (year[年], month[月], day[日], weekday[曜日]) where 条件式: ・引数が多くなってしまう場合はタプルを用いて一旦ひとまとめにしてから条件判定を行うと便利 ・条件判定はwhere句を用いることで条件の見通しを良くする（ちょっとSQLっぽいかも） switch (year, month, day, weekday) { //1月1日: 元旦 case (_, 1, 1, _): return true //1月2日: 振替休日 case (_, 1, 2, .Mon): return true //(1).1月15日(1999年まで)、(2).1月の第2月曜日(2000年から): 成人の日 case (year, 1, 15, _) where year <= 1999: return true case (year, 1, 8...14, .Mon) where year >= 2000: return true //2月11日: 成人の日 case (_, 2, 11, _): return true //2月12日: 振替休日 case (_, 2, 12, .Mon): return true タプルとは？：http://blog.kitoko552.com/entry/2015/06/17/213553 ・型の異なるものをひとまとめにしてくれる ・switch文の条件判定の条件にタプルを設定することが可能 ・必要な部分だけを抜き出してwhere句で条件判定をする 場合： monthが1 かつ dayが8から14の間 かつ weekdayが月曜日（enumで設定） 条件： yearが2000以上 ※2000年以降の1月の第2月曜日である[成人の日の判定]
- 10. ✦ 予め判定しておきたい曜日に関してはenumに定義してまとめておく Swiftでより柔軟になったenumの活用 enumの中にメソッドやコンストラクタの設定を行うことで関連する値を扱いやすく整理しておくと良いです。 ★Swiftではenumを柔軟に扱うことができる（メソッドやコンストラクタの設定） ・カレンダーの曜日を判定する部分についてはiOS8から使える dateWithEra()メソッドを使用している iOS8からの日付(NSDate)操作・比較：http://qiita.com/_mpon/items/c5b9573b4250f9a1d567 public enum Weekday: Int { case Sun, Mon, Tue, Wed, Thu, Fri, Sat init?(year: Int, month: Int, day: Int) { let cal = NSCalendar.currentCalendar() guard let date = cal.dateWithEra(AD, year: year, month: month, day: day, hour: 0, minute: 0, second: 0, nanosecond: 0) else { return nil } let weekdayNum = cal.component(.Weekday, fromDate: date) // 1:日曜日 〜 7:土曜日 self.init(rawValue: weekdayNum - 1) } var shortName: String { switch self { case .Sun: return "日" case .Mon: return "月" case .Tue: return "火" case .Wed: return "水" case .Thu: return "木" case .Fri: return "金" case .Sat: return "土" } } ・・・（一部省略）・・・ enumの中にコンストラクタを設定可能： ここでは現在の日付もとにしてカレンダー情報から曜日だけを抜き出すようにしている。 最後にself.init(rawValue: weekdayNum - 1)としてenumのrawValueの初期値を設定する。 ※ enumで設定した値と合わせるために -1 をしている。 enumの設定を利用するものによって変わりうる値の一覧などは、 このように設定しておくと後で色々と活用ができます。
- 11. ✦ 春分の日と秋分の日を算出する計算ロジック enumのメソッドを活用している例 このように結構すっきりとまとめてしまえば、条件分岐で利用する場合でも見通しがよくなると思います。 ★ここもenumを駆使して他のメソッドで扱いやすいようにする 春分）case (year, 3, day, _) where PublicHolidaysLawYear < year && day == SpringAutumn.Spring.calcDay(year: year): 秋分）case (year, 9, day, _) where PublicHolidaysLawYear <= year && day == SpringAutumn.Autumn.calcDay(year: year): 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 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)) } } 使い方はこんな感じで使います。 春分の日と秋分の計算の方法は実はきちんと天文学的に決まっているみたいです。 なのでこの部分についてはキャストをしています。 ※詳しいことについては参考URLをご一読くださいませ。
- 12. ✦ 独立した条件判定をするメソッドを定義して利用しやすくする ゴールデンウィーク・シルバーウィーク判定 この部分は実装をする上でもテストケースを作成する部分でもかなり試行錯誤をした部分でした…(キツイ) ★ゴールデンウィークで5/6が振替休日になる場合とシルバーウィークになる場合 /** * * ゴールデンウィークの振替休日を判定する * 2007年以降で5/6が月・火・水(5/3 or 5/4 or 5/5が日曜日)なら5/6を祝日とする * See also: https://www.bengo4.com/other/1146/1288/n_1412/ * */ private func getGoldenWeekAlterHoliday(year: Int, weekday: Weekday) -> Bool { switch weekday { case .Mon, .Tue, .Wed where 2007 <= year: return true default: return false } } /** * * シルバーウィークの振替休日を判定する * 敬老の日の2日後が秋分の日ならば間に挟まれた期間は国民の休日とする * */ private func getAlterHolidaySliverWeek(year year: Int) -> Bool { return oldPeopleDay(year: year) + 2 == SpringAutumn.Autumn.calcDay(year: year) } 実際のswitch文での条件判定： case (_, 5, 6, _) where getGoldenWeekAlterHoliday(year, weekday: weekday): 実際のswitch文での条件判定：※敬老の日は別途oldPeopleDayメソッドで計算を行っている case (_, 9, _, _) where oldPeopleDay(year: year) < day && day < SpringAutumn.Autumn.calcDay(year: year) && getAlterHolidaySliverWeek(year: year):
- 13. ✦ 各テストケースもタプルに入れて判定をする XCTestでの祝祭日判定の検証 ちなみにこちらは随時追記していく予定＆日本の法律が変わったらアップデートをしていく所存です。 ★該当祝祭日の年月日と期待される値をタプルに持たせてまとめて判定する ・テストがあるとやはり開発する側も使う側もお互いに安心をして使えるのは非常に心強く思う ・特に計算で検知する部分（ゴールデンウィーク・シルバーウィーク・春分の日・秋分の日）では大助かり func testCurrentYear() { let test = CalculateCalendarLogic() //2016年の場合のテストケース let testCases: [(Int,Int,Int,Bool)] = [ // 敬老の日: 2016年9月19日(月曜日) (2016, 9, 19, true), // 秋分の日: 2016年9月22日(木曜日) (2016, 9, 22, true), ] testCases.forEach { year, month, day, expected in let result = test.judgeJapaneseHoliday(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) } } } 実装のポイント： XCTAssertTrueでテスト結果がtrueになることを、 XCTAssertFalseでテスト結果がfalseになることをテストする。 あら〜残念！ 今年はシルバーウィークではないですね