---
name: "Weather::Com::Moon"
section: "3pm"
platform: "linux"
package: "libweather-com-perl"
version: "0.5.3-2"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/Weather::Com::Moon"
---

# Weather::Com::Moon(3pm)

Weather::Com::Moon - class containing moon phase information

```
  #!/usr/bin/perl -w
  use Weather::Com::Finder;
```

```
  # you have to fill in your ids from weather.com here
  my $PartnerId  = 'somepartnerid';
  my $LicenseKey = 'mylicense';
```

```
  my %weatherargs = (
        'partner_id' => $PartnerId,
        'license'    => $LicenseKey,
        'language'   => 'de',
  );
```

```
  my $weather_finder = Weather::Com::Finder->new(%weatherargs);
```

```
  my @locations = $weather_finder->find('Heidelberg');
```

```
  my $currconditions = $locations[0]->current_conditions();
```

```
  print "The moon phase is currently ",
    $currconditions->moon()->description(), "\n";
```

Via *Weather::Com::Moon* one can access the current moon phase. This class will **not** be updated automatically with each call to one of its methods. You need to call the `"moon()"` method of the parent object again to update your object. You usually would not construct an object of this class yourself.  This is implicitely done when you call the `"moon()"` method  of one current conditions or forecast object.\
 **description(\[$language\])** Returns a textual description of the current moon phase. This description is translated if you specified the *language* option for you *Weather::Com::Finder*. This attribute is *dynamic language enabled*.\
 *icon()* Returns the number of the icon describing the current moon phase. Thomas Schnuecker, \<thomas@schnuecker.de\> Copyright (C) 2004-2007 by Thomas Schnuecker This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. The data provided by *weather.com* and made accessible by this OO interface can be used for free under special terms.  Please have a look at the application programming guide of *weather.com* (\<http://www.weather.com/services/xmloap.html\>)!