選択された年月という変数名は何をつけるべきか

Question

前提・実現したいこと

選択された値を使いデータベースから値を持ってきたい場合に、どういった変数名を付ければよいのかわかりません。

試したこと

selectYMという変数名を付けたのですが、これでは何のデータを持ってくるために選択された年月なのかわからないような気がします。

何かよい変数名はないでしょうか？

回答よろしくお願いいたします。

追記

勤怠情報の1ヵ月分を持ってきたい場合の変数名となります。

Comments

[y_waiwai]

> これでは何のデータを持ってくるために選択された
とありますが、何のデータなんでしょうか？
そこらへん詳しく説明しないと答えようがないんでは。

[gentaro]

「選択された日付」以外のヒント抜きに名前を考えてくれと言われても困りますわな…。

[riose]

追記として追加しました。
指摘ありがとうございます。

Answer 1

selectYMという変数名を付けたのですが、これでは何のデータを持ってくるために選択された年月なのかわからないような気がします。

正直なところ、整合性がとれていれば問題ないです。
マジックナンバーとか「選択」「年月」すらも分からない変数名は論外ですが、
「何のデータを持ってくるために」というのはおそらく何かしらのクラスなどに所属することになる変数とするならば、そのクラスで「何のデータ」かが決まるのでそこまで長たらしい名前を付ける必要はないと思います。

用途次第では「select」すらも省略して問題ないケースもあると思います。

ケースバイケースですね。

Comments

[riose]

なるほど、確かにそうですね
クラス名として記載してあるので必要無いというのは思い付きもしませんでした。
ご回答ありがとうございます。

[m.ts10806]

結構「所属」って大事です。
クラス→メソッド名→変数名
と辿るだけでも意味が分かるようにできるのが理想です。
コードもシンプルになります。

[m.ts10806]

>勤怠情報の1ヵ月分を持ってきたい場合の変数名
勤務情報のクラスのgetTermWorkData というメソッドで取得するなら
[ym] だけでも良さそうですね。
term（期間）が何か＝ymで「指定年月」だと分かります。

[riose]

まだまだ分かりやすい変数名のつけ方が分かっていないため、非常に参考になりました。
別の例までつけて頂き、本当にありがとうございます。

[m.ts10806]

あくまでコードを組む側の都合なので、もし参画したプロジェクトに命名規則がきちんと定められているようでしたらそれに従ってください。
※おおよそは既存のガイドラインにそったものとは思います

Answer 2

これでは何のデータを持ってくるために選択された年月なのかわからないような気がします。

おっしゃるとおりだと思います。

元々テーブル項目名が、xxxx_YMとかxxxx_YMDのように何の年月(日)かついていると思いますので、
select_xxxx_YMとか、req_xxxx_YMとかその名前の前に何か付ければ良いかと。

Comments

[riose]

項目名をつけるというのにはとても納得でき、参考になりました。ありがとうございます。

Answer 3

その変数を利用する文脈によって、例えば「複数の候補から選択された年月」という意味がわかれば十分な場合はselectYMでも良い気はします。（個人的にはselectedYMだと思うけど）

似た候補としては、これも文脈次第でcurrentYMとかでも良いかもしれませんが。

単純に営業月っ意味で良いならbusinessMonthとか？

Comments

[riose]

参考になりました。
ありがとうございます。